Skills

Skills are reusable instruction packages that help Kindo handle a specific task consistently. A skill contains a required SKILL.md file with a name, a description, and instructions. It can also include supporting files such as reference material, templates, or scripts.

This guide covers creating, sharing, and managing skills.

Create a Skill in Chat

Ask Kindo to turn a repeatable set of instructions into a skill. For example:

Create a skill that turns meeting notes into a concise summary with decisions, action items, and open questions. Do not invent details that are not in the notes.

Review the drafted SKILL.md, make any changes you need, then ask Kindo to save it. You can find the saved skill in Skills.

To write the package yourself, follow the steps below.

Create a Skill Package

Create a folder for each skill. Put one SKILL.md file at the root of that folder. File paths inside the package must be relative to the folder.

Write `SKILL.md`

Start with YAML frontmatter between --- lines. The name and description fields are required. Use a lowercase, hyphen-separated name with up to 64 characters.

---
name: meeting-notes
description: Turn meeting notes into a concise summary with decisions and next steps.
---

# Meeting notes

Summarize the supplied notes in this order:

1. Key decisions
2. Action items, including an owner when one is named
3. Open questions

Do not invent decisions, owners, or dates that are not in the notes.

Write instructions that state the task, the expected output, and important boundaries. Specific instructions are easier to reuse than broad requests such as “help with meetings.”

Add Supporting Files When Useful

Keep optional files in the same folder, for example:

meeting-notes/
├── SKILL.md
└── references/
    └── team-terms.md

Reference supporting files by their relative paths in SKILL.md when the instructions need them. A package can contain up to 64 files. SKILL.md can be up to 64 KiB, each other file up to 256 KiB, and the complete package up to 2 MiB.

Upload a Skill

Open Skills

In Kindo, select Skills from the navigation.
Start an upload

Select Upload skill, then select Choose folder.
Choose the package folder

Select the folder that contains SKILL.md. Kindo inspects the package and shows the name, description, file count, and size before upload.
Confirm the upload

Select Upload. The skill appears in your Skills library when the upload succeeds.

Each single-skill package must contain exactly one root SKILL.md. Kindo rejects unsafe paths, duplicate paths that differ only by letter case, packages that exceed the limits, and frontmatter that does not meet the required format.

Browse the Skills Library

The Skills library lists every skill you can view: skills you created and skills shared with you. The Creator column shows who created each skill.

Use the Source filter to narrow the list:

Source	Shows
All	Skills you created and skills shared with you or your organization.
Created by Me	Skills you created.
Shared with Me	Skills shared with one of your user groups.
Organization	Skills shared with everyone in your organization.
Admin View	Every skill created by a member of your organization, including skills that are not shared. Available to organization administrators.

Each row has a menu with Edit, Share, and Delete. Share and Delete appear only when you have permission for that skill.

Inspect and Use a Skill

Select a skill in the Skills library to view its description, instructions, and files. Select a file to preview it when it is text. Markdown files render as Markdown; a binary file or a file that is too large to preview can still be downloaded with Export.

Use skills in AI Chat by asking about the task the skill describes. You can also attach a skill you created to an agent you can edit, and administrators can attach any skill in the organization. Everyone who can use the agent then uses the skill, whether or not it was shared with them:

Open the agent in the agent builder.
In the Skills section, select Attach skill.
Select the skill and confirm the attachment.

For more on creating an agent, see Creating and Managing Agents.

What an Attached Skill Reaches

An attached skill reaches every LLM step of the agent and every chat with it, in every run, including runs started by a schedule, a trigger, or the API. Each LLM step sees the names and descriptions of the attached skills and can open a skill’s instructions and files when its task matches the skill’s description, whether or not the step’s prompt mentions the skill. A step in Actions mode can then carry out those instructions with its tools, including running the skill’s scripts itself. A step in Ask mode can read the skill but cannot run commands or call integration tools.

Attaching a skill is also what lets a Script step run one of its scripts without a model. To keep a skill’s scripts to the Script steps, see Structure an Agent Around Script Steps.

Duplicating an agent attaches its skills to the copy. A skill you can’t attach is left off the copy, and if a Script step runs it, the agent can’t be duplicated. Ask the skill’s creator or an organization administrator to duplicate it.

A skill starts private: only its creator and your organization’s administrators can see it. To let other people in your organization use it, open the skill’s row menu in the Skills library and select Share.

User Group Permissions: select Add Group, then choose a user group. Members of that group get Viewer access. To take a group’s access away, change its access level to Remove.
Organization Access: select Viewer to let everyone in your organization view the skill, or None to limit access to the groups you chose.

Viewer access lets a person find the skill in their library, view its instructions and files, export it, and use it in AI Chat. It does not let them attach it to agents. Everyone who can view an agent sees the names of its attached skills and of their scripts; opening one from the agent still needs viewer access to the skill itself.

Only the skill’s creator and your organization’s administrators can edit, share, delete, or attach it to agents. If your organization’s Sharing Permissions set the minimum role for sharing to Admin, only administrators can share skills.

Update a Skill

To publish a new version, open the skill and select Upload new version. Choose a single folder whose root SKILL.md has the same name as the existing skill.

The skill’s creator and your organization’s administrators may update it, view its version history, restore an earlier version, or delete it.

Uploading a new version replaces the complete package. Include every file that the new version needs; files omitted from the uploaded folder are not part of the new version. The skill keeps its name and version history, and the library opens the new version after upload.

If a normal upload uses a name that already exists, Kindo reports the conflict and offers Replace existing skill?. Review the package name before confirming, because replacement uses the name in SKILL.md.

Version History and Restore

Select Version history on a skill to view its versions. Open a prior version to inspect its instructions and file list.

To return to an earlier version, select Restore this version and confirm. Kindo creates a new current version with the earlier version’s content; it does not remove the versions already in history.

Export or Delete a Skill

Select Export on a skill to download its package as a ZIP archive. Export before making a significant change or deleting a skill if you want a local copy.

Select Delete and confirm to remove a skill. The skill’s creator and your organization’s administrators can delete it. You cannot undo deletion from the Skills library.

Troubleshooting

Problem	What to check
Upload cannot find a skill	Select the package folder itself, and make sure one root `SKILL.md` is inside it.
Upload rejects the name or description	Check that frontmatter is valid YAML, `name` is lowercase and hyphen-separated, and both required fields have values.
Upload exceeds a limit	Reduce the number of files or their sizes. The package limit includes `SKILL.md` and all supporting files.
A new version is blocked	Upload a single folder and make sure its `SKILL.md` name matches the skill you opened.
Upload new version reports that the version has changed	Someone published or restored a version after you opened the skill. Kindo opens the current version; review it, then upload again.
A file will not preview	Use Export to download the package; binary files and large files are not previewed in the browser.