Skip to content

Open .skill ProtocolSealed, inspectable packages for AI agent skills

Chat context vanishes. Markdown skills drift. Sealed .skill packages carry typed I/O, workflow, and inspect-before-run trust โ€” install once, then talk to your AI.

Sealed .skill packages โ€‹

The Open .skill Protocol is an open specification and portable .skill format so AI agents can author, inspect, hand off, and run skills across hosts. skillerr is the reference implementation CLI.

Format: .skill (sealed ZIP) ยท Status: 1.0.0 (Stable)
Reference CLI: skillerr (bin: skill)
Repo: dot-skill/skillerr

Install once โ€‹

bash
npm i -g skillerr

Node โ‰ฅ 20. After that, talk to your agent โ€” not a human CLI checklist.

Talk to your AI โ€‹

Create from this chat

text
Run these exact commands in your terminal, in order:

1. npm i -g skillerr          (skip if `skill --version` already works)
2. export SKILL_HOST=cursor   (replace "cursor" with your actual tool name)

Then, from this conversation, create a portable .skill with a redacted journey
and exact sections I approved (secrets as {{refs}}). Checkpoint for handoff, or
compile --approve --mint when release-complete. Do not invent filler. Show
status and the output path.

Inspect before run

text
Inspect ./file.skill TrustView without executing. Validate, then dry-run.
Summarize trust warnings. Do not execute for real unless I ask.

More starters: Getting started ยท Convert a SKILL.md ยท Evaluate & score ยท Agents ยท Workflows

What's in a .skill โ€‹

text
example.skill
โ”œโ”€โ”€ skill.json           # manifest, digests, profile, completeness
โ”œโ”€โ”€ workflow.json        # runnable steps
โ”œโ”€โ”€ knowledge/           # pinned decisions / rules
โ”œโ”€โ”€ provenance/          # redacted journey + generation_usage
โ””โ”€โ”€ signatures/          # mint attestation (release)

Reference packages โ€‹

SurfaceRole
skillerrReference CLI
@skillerr/protocolSkillContract, schemas, types
@skillerr/coreCompile, pack, validate, mint
@skillerr/runtimeInspect / dry-run / execute
@skillerr/workspaceLocal .skill/ working tree
@skillerr/registryOptional local transparency log

Open .skill Protocol โ€” Draft 0.5.0