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 agentmy-package/
├── package.json
├── src/index.ts
└── skills/
└── hello-skill/
├── SKILL.md # required
├── references/ # optional
├── scripts/ # optional
└── assets/ # optionalA 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 packageOpen a skill from any connected agent
An agent finds the skill through Kody search, then opens the file.
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