Organisation skills

An organisation skill is a skill your administrators write once for the whole company. You choose which AI assistants list it: DataMind Oda, Minds and the other AI assistants in DataMind OS. Manage organisation skills on the Skills tab of AI Configuration. To learn how assistants use skills, see Skills a Mind can load.

Before you start

To open the Skills tab, you need View AI Skills or Modify AI Skills. The AI Skills Viewer standard permission includes View AI Skills: you can read organisation, built-in and Mind skills, and export them.
To create, edit, import, restore, delete and promote skills, you need Modify AI Skills, which the AI Skills Manager standard permission includes.
With only the skills permissions, AI Configuration shows the skills page alone, without the Connection & models tab.

See the Permission reference.

Find your way around

Open Admin in the sidebar, then choose AI Configuration at the top of the page.
Click Skills. If you hold only the skills permissions, the skills page opens directly.

The list shows one kind of skill at a time. Switch with the tabs above it:

Tab	What it lists	What you can do
Organization	Your company's organisation skills, with their Agents, Forced, Roles, Revision, Last test, Usage and Updated columns.	Create, edit, import, export, restore, delete and test.
Built-in	The skills that come with DataMind, with the assistants that use them.	Read and export.
Mind skills	The skills of every Mind in the company, with the Mind that owns each one, its author, its Last test and its Usage.	Read, export and promote to the organisation.

Type in Search by name or title to narrow the list. Click a row to open the skill on the right. A skill marked Hidden has the same name as a built-in skill, so assistants never load it.

Create an organisation skill

On the Organization tab, click New skill.
On Document, write the skill in SKILL.md. Use Write to edit the Markdown and Preview to read it formatted.
To add a reference, click the Add reference button after the document tabs, then fill its Key, Title and text. A skill can have up to 8 references. The assistant loads a reference only when a step of the skill needs it.
On Settings, fill the fields:
- Name: lowercase letters, digits and single hyphens. People run the skill with /name. The name cannot be changed later.
- Title and Description: say what the skill does, when to use it and when not to. Assistants see the first 500 characters of the description.
- When to use (optional): extra text that helps assistants and Oda decide when to load the skill.
- Agents: the assistants that list the skill. Pick at least one.
- Delivery to Oda: shown when you pick Oda. Managed: your edits reach everyone, and removing the skill removes it from everyone. Install once: each person gets a copy they own, and later edits do not reach them. You cannot change it after you add the skill.
- Forced, Only with /name and Slash command: see the next section.
- Only for specific roles: turn it on and pick the roles to limit the skill to them. Otherwise everyone who uses the picked assistants gets it.
Click Save in the bar at the bottom of the page.

To start from a file, click Import instead of New skill, pick a SKILL.md file or a .zip with SKILL.md and references/*.md, and click Read file. The skill opens as a new draft. Nothing is saved until you review it and click Save.

Choose the assistants

Under Agents	Who lists the skill
Oda	DataMind Oda. See Manage DataMind Oda.
Analytical Minds	Analytical Minds.
Warehouse Builder Minds	Warehouse Builder Minds.
Lake Builder Minds	Lake Builder Minds.
Model AI	Model AI.
Lake connector assistants	The connector agent in Connect Anything and the AI assistant for API recipes.
Slides AI	The AI panel in Slides.
Custom Visual AI	The AI that writes custom visuals.

Required skills and slash commands

Forced: every assistant you picked lists the skill, and nobody can turn it off. In a Mind's Skills tab it shows Forced with a lock, and in Oda it shows Required by your organization. A forced skill needs Managed delivery and cannot be limited to its /name command.
Only with /name: assistants never load the skill by themselves. It runs only when someone types /name.
Slash command: people can run the skill by typing /name in a chat.

Change, restore or delete a skill

Click the skill in the list. You need Modify AI Skills to edit it.
Change the Document or the Settings, then click Save. Every save is a new revision.

The buttons at the top of the skill:

History lists every revision with its author and time. Select one to read it under Revision, or open Changes and pick a revision in Compare with to see what changed. Restore this revision saves the old text as a new revision.
Export downloads the skill as a .zip with SKILL.md and its references.
Delete removes the skill. Assistants and Oda users stop getting it within minutes. The name stays reserved, so a new skill needs a new name.

If someone else saved the skill while you were editing, saving shows This skill changed. Click Reload the skill to load the newest revision and drop your edits, or Keep my edits to copy your text out first. Until you reload, the skill shows a note with the newer revision number, and saving asks again.

See how a skill is tested and used

Two columns in the list tell you how a skill is doing:

Last test shows the result of the skill's newest benchmark, for example Passed 85%, Did not pass, Running or Paused, or Not tested. Point at it to read the revision it tested, the pass rates of the tested and the compared version, and when it ran.
Usage shows how many times assistants loaded the skill in the last 30 days, across every Mind and agent, and how many of those loads were followed by no tool call (unused). Not loaded means no load in that time. Only the times an assistant loaded the skill on its own count.

When you open a Mind skill, a Tests block above its text shows the same: Last benchmark with the result, the revision and the age, or Not benchmarked yet., and the usage line. An organisation skill shows it on its Tests tab. View results opens the newest benchmark in a window. You can read it there, but not change it.

On a Mind skill, Open tests in and the Mind's name opens the skill's tests in the Skills tab of the Mind that owns it. It appears when you have View Mind Skills and can open that Mind. See Test a skill.

Test an organisation skill

An organisation skill that is saved has a Tests tab next to Document and Settings. It shows the Tests block and the skill's tests from every Mind. Click a test to read its results.

To run a benchmark, you need Modify AI Skills and View Mind Skills, and you must manage the Mind the test runs in:

On Tests, pick a Mind under Pick a Mind. The list holds your Minds that the skill applies to, by their kind and the skill's Agents.
Click Open tests. The Mind's Skills tab opens on the skill's tests.
Write the test tasks and run the benchmark there. See Test a skill in the Skills tab.

The test tasks of an organisation skill are shared by every Mind that tests it. Benchmarks run in the Mind you pick, with your access. Open tests is greyed out while the skill has unsaved changes: save or discard them first.

Promote a Mind skill to the organisation

A skill that works well in one Mind can become an organisation skill for every assistant you choose. The Mind keeps its own copy.

On the Mind skills tab, click the skill and read it.
Click Promote to organization.
Check the Name, pick the Agents and, if needed, turn on Forced or Only for specific roles.
Click Promote.

The new organisation skill uses Managed delivery and is not limited to its /name command. Its Slash command setting follows the Mind skill.

Nobody can promote a skill they wrote or edited: another administrator has to do it. If you created the skill, the button is disabled for you.
The revision you promote needs a passing benchmark: the latest completed benchmark of exactly that revision must have tested the saved revision and passed. Someone who manages the Mind that owns the skill runs the benchmark, in the Mind's Skills tab or in a chat with that Mind. See Test a skill.
While no benchmark of the revision exists, Promote to organization is disabled. Point at it to read why.
Otherwise the window says what the newest benchmark of the revision shows: that it passed, that it did not pass, or that it is still running or tested an unsaved version. The check itself runs when you click Promote. If it fails, the window shows why with Run a passing benchmark of this revision, then promote again., and Promote stays disabled.
If the Mind skill gets a new revision while the window is open, Promote is refused and the window says so. Close it, read the new revision, then promote again.
If the promoted skill keeps its name and reaches the Mind it came from, the Mind's own copy shows Hidden there, because the organisation skill wins.

Limits

What	Limit
Organisation skills	64 for the whole company
Name	Lowercase letters, digits and single hyphens, up to 64 characters
Title	60 characters
Description and When to use	1,024 characters each. Assistants see the first 500 characters of the description.
Skill text	28,000 characters
References	8 per skill, each up to 20,000 characters

Some names cannot be used: the name of a built-in DataMind skill, such as star-schema; the names of the DataMind Oda built-in skills skill-authoring, office-docx, office-pptx, office-xlsx and datamind-badge; the Windows device names con, prn, aux, nul, com1 to com9 and lpt1 to lpt9; and any name that another skill of your company has, or had before it was removed. If a save is refused, the message says why. See Administration troubleshooting.

Questions, answered

How long until people get a new or changed skill?

Assistants in DataMind OS use it from their next message. Oda checks for changes on its own and gets them within 10 minutes, without a restart.

Can I rename an organisation skill?

No. The name is fixed, because Oda stores the skill under its name and people run it with /name. To use another name, create a new skill and delete the old one. The old name stays reserved.

Why can't I save a skill with Forced on?

A forced skill must use Managed delivery and cannot be limited to its /name command. Choose Managed under Delivery to Oda, or turn off Only with /name.

Why does a skill show Hidden?

A built-in DataMind skill has the same name, and the built-in skill always wins, so assistants never load yours. Create a skill with another name.

Can I give a skill to some roles only?

Yes. On Settings, turn on Only for specific roles and pick the roles. If none of the picked roles is active any more, Roles shows Nobody in the list, and the skill reaches nobody.

Why is Promote to organization disabled for me?

Point at the button to read why. Either you wrote or edited this Mind skill, and another administrator with Modify AI Skills has to promote it, or the revision has no benchmark yet.

What does unused mean in the Usage column?

An assistant loaded the skill but called no tool after it in that chat. Many unused loads can mean that the description makes assistants load the skill for requests it does not cover. For a Mind skill, a trigger test or description tuning in the Mind that owns it shows which requests load it. See Test a skill.

Why does Promote say the skill needs a benchmark?

Promotion needs a passing benchmark of the revision you promote. If no benchmark of that revision exists, Promote to organization is disabled. If no benchmark of that revision has completed, or the latest one did not pass, the promotion is refused and the window names the revision and the reason. Ask someone who manages the Mind to run a benchmark of that revision in its Skills tab. A benchmark passes when the tested revision passes at least 80% of its checks on average, no fewer than the version it is compared with, and every task has at least 2 graded runs for both versions. See Test a skill.

Can I change the delivery to Oda later?

No. To change it, delete the skill and add it again with a new name, because a removed name stays reserved.

How do I copy a skill to another DataMind OS?

Click Export on the skill to download a .zip, then use Import on the Organization tab of the other DataMind OS and save the draft.

What happens to a Mind skill after I promote it?

Nothing. The Mind keeps its own skill, and later edits in the Mind do not reach the organisation skill. To update the organisation skill, edit it here.