Skip to content

Teach every agent
the same playbook.

A skill is a set of instructions an agent loads when a task calls for it. Put Agent Skills in a Kody package and everyone who can read the package works from the same published version.

Connect your agent
Example package skill
skills/hello-skillPublished
my-package/
├── package.json
├── src/index.ts
└── skills/
    └── hello-skill/
        ├── SKILL.md      # required
        ├── references/   # optional
        ├── scripts/      # optional
        └── assets/       # optional

A skill is a folder under skills in a package, with a required SKILL.md file.

A folder and a file.
Checked at publish.

Each skill is one folder at skills/<name>/SKILL.md, following the open Agent Skills specification. The folder is the declaration. There is nothing else to register.

Skills go through the same publish checks as the rest of the package. A skill with a missing name or description fails the publish, and nothing goes live.

How to ship skills in a package

Open a skill from any connected agent

An agent finds the skill through Kody search, then opens the file.

Kody search
search({
  entity:
    'package:@you/my-package#skills/hello-skill/SKILL.md',
})

A search call that opens one skill file.

Browse them.
Compare versions.

Open Skills in your workspace to see published skills across the packages you can read. Search by skill or package name, then read the instructions and their supporting files.

History shows earlier published versions and what changed between them. People who can write to the package can restore one skill folder as a new version, through the normal publish checks.

See what gets read

The Skills page shows the last 30 days of reads: instruction reads, supporting-file reads, distinct people, and the most-read skills.

A read means Kody delivered or displayed the file. It is not proof that an agent followed the instructions.

What counts as a read

Ask your agent to write one.

Serving skills directly through the Skills extension for MCP is an opt-in experiment, because support in agent apps is still partial. See which hosts support it

Start with the instructions you keep repeating.

Read the package skills guide

Connect your agent