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 skills you create and manage yourself.

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

1. Open Skills

   In Kindo, select Skills from the navigation.

2. Start an upload

   Select Upload skill, then select Choose folder.

3. 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.

4. 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.

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 own to an agent:

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

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

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.

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 from your library. 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 replacement is blocked	Upload a single folder and make sure its SKILL.md name matches the skill you opened.
A file will not preview	Use Export to download the package; binary files and large files are not previewed in the browser.

Next Steps

• Create and manage agents
• Learn about AI Chat