# Skills & examples

Skillkren follows the open [Agent Skills](https://agentskills.io/specification) format used by Claude, Codex, Cursor, and others. A skill is a folder:

```
pdf-processing/
├── SKILL.md        instructions (required)
├── LICENSE.txt     license terms (optional)
├── references/     docs the agent reads only when needed
├── scripts/        code the agent can run
└── assets/         templates and data
```

## A skill

- **Title**: becomes the folder `name` (lowercase, dashes) on export.
- **Description** (required): what the skill does *and when to use it*. Agents read this first to decide whether to load the skill, so name the situations and keywords.
- **Instructions**: the body of SKILL.md, in Markdown. Keep it under about 500 lines and move long material into references.
- **Tags** (optional, up to 3).
- **License** (optional): MIT, Apache 2.0, CC BY 4.0, CC0, Proprietary, or any other. Add full terms and they're exported as LICENSE.txt.
- **Requirements** (optional): only if the skill needs specific tools or access, e.g. "Needs Python 3.12 and internet access". Exported as `compatibility`.
- **Visibility**: Private (the default), a team, Unlisted, or Public. See [/docs/visibility](/docs/visibility).

Paste a whole SKILL.md when creating a skill and the title, description, and license are filled in from its frontmatter.

Stable URL: `/u/<username>/skills/<uuid>`

## References and other files

Open a skill's **References** tab to add files under `references/`, `scripts/`, or `assets/`. Mention each one in SKILL.md by its path (for example "For the full style rules, read `references/style-guide.md`") so the agent knows when to open it. Text files only, up to 100 KB each and 30 per skill.

## Examples

Examples belong to a skill and show real output. They're what makes a skill trustworthy: a teammate or an agent can see exactly what "good" looks like.

- Index: `/app/skills/<uuid>/examples`
- Detail: `/app/skills/<uuid>/<example-slug>`

## Version history

Every edit to the instructions, description, tags, or license saves a numbered version. The Free plan shows the latest 2; Pro and Team show all of them.

## Copy, download, install

- **Copy skill** copies the exact SKILL.md instructions.
- **Download .zip** gives you the whole folder (SKILL.md with frontmatter, LICENSE.txt, references).

To install a download:

- **Claude (app):** Settings → Capabilities → Skills → upload the zip.
- **Claude Code:** unzip into `~/.claude/skills/` (or `.claude/skills/` in a project).
- **Codex / Cursor / others:** unzip into the app's skills folder (for example `~/.codex/skills/`).

Or skip the download and connect your agent over MCP, so it always reads the latest version. See [/docs/connectors](/docs/connectors).
