Authoring skills
A PapiSkill package is a folder with `skill.yml` and `SKILL.md`. Keep skills portable, inspectable, and honest about safety boundaries.
my-skill/ skill.yml SKILL.md examples/ scripts/ assets/
Use `skill.yml` for metadata: id, name, summary, description, categories, tags, license, compatibility, and install targets.
Use `SKILL.md` for agent-facing instructions. Name when to use the skill, what inputs it expects, what outputs it should produce, and which actions require explicit user approval.
Global registry publishing is collaborator-approved. Public profile skills can be published by users directly, but curated global status means the package is visible in the main registry.