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
Section titled “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
Section titled “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
Section titled “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 and a description of up to 1024 characters.
---name: meeting-notesdescription: Turn meeting notes into a concise summary with decisions and next steps.---
# Meeting notes
Summarize the supplied notes in this order:
1. Key decisions2. Action items, including an owner when one is named3. 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
Section titled “Add Supporting Files When Useful”Keep optional files in the same folder, for example:
meeting-notes/├── SKILL.md└── references/ └── team-terms.mdReference 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
Section titled “Upload a Skill”Kindo accepts two package layouts:
- A skill folder: one
SKILL.mdat the root of the folder, with its supporting files beside it. - A plugin bundle: a folder with a
plugin.jsonfile at its root and one or more skill folders underskills/. Each skill folder uploads as its own skill. Kindo skips anything else in the bundle, including a folder underskills/with noSKILL.mdand, in a bundle with more than one skill, any skill that fails the checks below. It lists what it skipped before upload.
-
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 skill folder, or the bundle folder that contains
plugin.json. Kindo inspects the package and shows what it will upload before you confirm. -
Confirm the upload
Select Upload. The skill appears in your Skills library when the upload succeeds.
A skill folder must contain exactly one root SKILL.md. When you upload one skill, Kindo rejects unsafe paths, duplicate paths that differ only by letter case, a package that exceeds the limits, and frontmatter that does not meet the required format.
Browse the Skills Library
Section titled “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
Section titled “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. The instructions show the SKILL.md body without its YAML frontmatter, so optional fields such as allowed-tools appear only in the exported file.
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, while the skill’s creator and the agent’s creator are in the same organization (see What an Attached Skill Reaches):
- 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
Section titled “What an Attached Skill Reaches”While the skill’s creator and the agent’s creator are in the same organization, 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. When there are too many skills to list, or their descriptions are too long, it sees only the attached skills’ names if those fit, and otherwise finds them by search. It 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 is told that the skills it sees are attached to the agent. 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. People outside your organization the agent is shared with use its attached skills too.
At runtime, an agent’s LLM steps and chats see only the skills attached to the agent. The skills you created or that are shared with you, but are not attached, are available in AI Chat, not in the agent. Who a run runs as decides which attached skills it can use when the attachment alone grants nothing (see below). A chat in Kindo and a run started from the agent builder run as you. A run started through the API runs as the person who created the API key. A run started by a schedule, a webhook, or an event from a connected integration runs as the agent’s creator.
A chat or an LLM step lists up to 64 skills when their descriptions fit. With more skills, or descriptions too long to fit, it sees the count instead of the list, plus the skills’ names in an agent when they fit, and searches the skills to find a match. A search matches a skill’s name, its description, and, for a skill in your library, the part of its creator’s email before the @ sign. It can also list only the skills you created.
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.
Attaching grants use of the skill only while the skill’s creator and the agent’s creator are in the same organization. If a move separates them, the attachment grants nothing: for anyone without their own access to the skill, the Skills section marks it Can’t be used by this agent, chats and LLM steps no longer see it, a Script step that runs it fails, and the agent builder’s Run button is disabled until that step is removed or pointed at another skill. People with their own access to the skill in its creator’s current organization, the creator included, keep using it through the agent. When the skill’s creator moves, the skill’s sharing is also removed; see Share a Skill. A skill that no Script step runs can be detached.
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.
Share a Skill
Section titled “Share a Skill”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, or select the Share icon on the skill’s page.
- 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.
When a skill’s creator moves to another organization, Kindo removes the skill’s user group shares and sets its Organization Access to None. The creator can share it again in their new organization.
Update a Skill
Section titled “Update a Skill”To publish a new version, open the skill and select Upload new version. Choose a skill folder, or a plugin bundle that holds one skill, whose SKILL.md has the same name as the existing skill. A bundle with more than one skill is rejected.
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
Section titled “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
Section titled “Export or Delete a Skill”Select Export on a skill to download its package as a ZIP archive. The archive is a plugin bundle: plugin.json at the root and the skill’s files under skills/<name>/. To upload it again, unzip it and choose the extracted folder. 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
Section titled “Troubleshooting”| Problem | What to check |
|---|---|
| Upload cannot find a skill | Select the skill folder itself, and make sure one root SKILL.md is inside it. For a bundle, select the folder that contains plugin.json. |
| 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 one skill, as a skill folder or a single-skill bundle, 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. |
