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 commits, reviewing code, writing frontend UI, or working with language-specific conventions.

Layout

• agents/: meta-skills for creating skills and agent instruction files.
• code-style/: review and prose-compression workflows.
• devops-engineer/: Docker, CI/CD, deployment, and infrastructure guidance.
• git/: Git, Forgejo, and GitLab workflows.
• languages/: language-specific engineering guidance.

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.