writing-pi-skills

What problem does it solve?

Ensures Pi skill authors and reviewers produce SKILL.md files that meet agentskills.io and Pi content rules so skills are discoverable, safe, and load reliably. It prevents common formatting mistakes that block auto-discovery or inject undesirable patterns into agent context.

Core Features & Use Cases

• Frontmatter validation: Verifies presence and format of required name and description fields and enforces naming rules like lowercase and hyphen usage.
• Context and content rule checks: Detects prohibited patterns such as @filename auto-load, Skill tool invocations, superpowers: prefixes, and ~/.claude/ paths.
• Use Case: Run when creating or editing a skill to catch directory-name mismatches, missing descriptions, or token-inefficient content before committing to the shared skills directory.

Quick Start

Review the SKILL.md in the target skill directory and list any missing frontmatter fields, naming or description violations, prohibited patterns, and suggested fixes.