Manage Tenant Skills
A Tenant Skill is a Skill your Tenant shares: the agent uses it for everyone you give access to, and they find it in their Skill Library. You decide who may use each Tenant Skill. For what Skills are and how the agent uses them, see Skills.
You need the Right “Manage Skill access”. Admins hold it. You work with Tenant Skills in the Web App, in the Skill Library.
Create a Tenant Skill
Section titled “Create a Tenant Skill”- In the Web App, choose Skills in the sidebar, then New Skill.
- Under Who is this Skill for?, choose My Tenant.
- Write the name, description, instructions and files as for a Personal Skill.
- Choose Create Tenant Skill.
The editor warns you: everyone who may use a Tenant Skill can read all of it, its files included. Put no credentials and no personal data in it.
A Tenant Skill’s name is unique in your Tenant, and a Standard Skill’s name can’t be used. A user’s Personal Skill may have the same name. Your Tenant can have up to 500 Tenant Skills.
A new Tenant Skill has no grants but yours: until you give access, only holders of “Manage Skill access” can use it.
Decide who may use a Tenant Skill
Section titled “Decide who may use a Tenant Skill”Each Tenant Skill has three Rights, which you give to users and to Groups:
| Right | What it allows |
|---|---|
| Use | Find the Skill in the Skill Library, read it, export it, and let the agent use it. |
| Propose | Use the Skill and propose changes to it. |
| Accept | Use the Skill and accept proposed changes to it. |
Propose and Accept each include Use. A user holds a Right directly or through any Group they are in. Holders of “Manage Skill access” hold all three on every Tenant Skill.
To give or take away access:
- Open the Tenant Skill in the Skill Library.
- Choose the Access tab. Only holders of “Manage Skill access” see it.
- Under Give access to a user or Group, choose a user or a Group and choose Give access. They can now use the Skill.
- Tick or clear Use, Propose and Accept in their row. Clearing Use, or choosing the bin at the end of the row, takes all their access away.
A change applies to the next Turn: a Conversation that is already answering keeps the Skills it started with. Someone without Use doesn’t see the Skill anywhere: not in the Skill Library, not in a Conversation, and not through the agent.
A Tenant Skill’s page tells each user what they may do with it, for example You may use this Skill and propose changes to it.
How a Tenant Skill changes
Section titled “How a Tenant Skill changes”Nobody edits a Tenant Skill directly. A user with the Right to propose changes opens a Skill Change Request in the editor or from a ZIP; a user with the Right to accept changes reviews it under To review in the Skill Library and accepts or rejects it. Accepting makes the next version and makes the Skill’s other open requests Stale. Each user may have 20 open requests. Rolling a Tenant Skill back needs the Right to accept and is recorded as an accepted request. The agent can open such a request for a user who holds the Right to propose, after the user’s Approval; its requests are marked as made by the agent. A holder of “Manage Skill access” can also have the agent create a Tenant Skill directly. See Skills for what users see.
Accept a Personal Skill that a user shares
Section titled “Accept a Personal Skill that a user shares”A user can ask to share a Personal Skill with the Tenant. With the Right “Manage Skill access” you find the request under To review in the Skill Library, marked Share, and read the whole Skill on its page: the description of what it is for, its SKILL.md and every file. Choose Accept… and then choose who gets the Rights to use the Skill, propose changes to it and accept them; its creator may propose changes in any case. Accepting turns the user’s Personal Skill into the Tenant Skill with the same versions, not a copy, and up to 20 grants can be given at once; give more on the Skill’s Access tab. If a Tenant Skill has the name already, accepting is refused. If the user changed the Skill after asking, the request is Stale and can only be rejected. Rejecting, with an optional comment, leaves the Personal Skill untouched. The audit log records the request being opened, accepted or rejected and each Right given.
See what a user or Group holds
Section titled “See what a user or Group holds”In the Admin App, the Users and Groups pages show, for each user and Group, Tenant Skills: the Tenant Skills they hold Rights on, and which Rights. The lists are read-only; change them on each Skill’s Access tab.
What the audit log records
Section titled “What the audit log records”The Audit Log records every Tenant Skill created and exported, and every Right given or taken away, with the Skill’s ID, the user or Group and the Right, never the Skill’s text. When Scavenger AI staff act in your Tenant, the entry says so.