Agent Skills

Reusable skills for pi and other coding agents.

Each skill is a small Markdown package that teaches an agent a focused workflow, such as creating agent instructions, writing documentation, opening pull requests, or preparing handoffs.

Layout

• agents/: meta-skills for creating skills and agent instruction files.
• code-style/: writing-style workflows.
• documentation/: product and technical documentation workflows.
• git/: Git and Forgejo workflows.
• productivity/: planning and handoff workflows.
• .archive/: retired skills retained for reference but excluded from the active skill set.

Skill format

Most skills live in their own directory with a SKILL.md file:

<category>/<skill-name>/SKILL.md

SKILL.md starts with YAML frontmatter containing at least name and description, followed by concise instructions for the agent.

Editing

Keep skills short and practical. Put long supporting material in references/, templates in assets/, and scripts in scripts/ when needed.