What problem does it solve? Turning a repeatable workflow into a reusable agent skill requires knowing the correct SKILL.md frontmatter format, directory conventions, and discovery rules, which are easy to get wrong without guidance. ## Core Features & Use Cases - Skill Authoring Guidance: Provides rules for writing focused SKILL.md files with proper name, description, frontmatter fields, and progressive disclosure of detail into references and scripts. - Scope and Location Selection: Directs placement of skills in project (.pi/skills/), user (~/.pi/agent/skills/), or repository convention (.agents/skills/) directories based on the requested scope. - Built-in Validation: Ships a validate-skill.mjs script that uses the Pi SDK to check discoverability, frontmatter diagnostics, and name-directory matching. - Use Case: After repeatedly asking the agent to draft release notes, use this Skill to turn that workflow into a reusable release-notes skill, validate it, and invoke it later via /skill:release-notes. ## Quick Start Ask the agent to create a skill that drafts release notes from repository changes and validate it with the bundled validator.
