writing-pi-skills

Validate Pi SKILL.md frontmatter and content rule compliance.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/jbro/pi-agent --skill writing-pi-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-pi-skills
Source: https://github.com/jbro/pi-agent/tree/main/skills/pi-skills/writing-pi-skills
Command: npx skills add https://github.com/jbro/pi-agent --skill writing-pi-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about writing-pi-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Pi skill SKILL.md files for frontmatter and content compliance?

Validate Pi skill SKILL.md files by checking for required name and description frontmatter, enforcing lowercase hyphen naming, and flagging prohibited patterns like @filename references and superpowers: prefixes to ensure reliable agent auto-discovery.

What content patterns are prohibited when authoring Pi skills?

Prohibited patterns in Pi skill authoring include @filename auto-load references, Skill tool invocations, superpowers: prefixes, and hardcoded ~/.claude/ paths, which can inject undesirable content or block safe skill loading.

How do I fix directory-name mismatches in Pi skill frontmatter?

Fix directory-name mismatches by ensuring the frontmatter name field exactly matches the skill directory name using lowercase and hyphens, preventing auto-discovery failures across ~/.pi/agent/skills and project-local .pi/skills directories.

When should I run validation checks on my agent skills?

Run validation checks when creating or editing a skill to catch missing descriptions, naming violations, or token-inefficient content before committing to the shared skills directory, ensuring your Pi skills remain discoverable and safe.

Can I use this validation for skills stored in project-local .pi/skills directories?

Yes, you can apply this validation to skill authors and maintainers creating or editing skills across both ~/.pi/agent/skills and project-local .pi/skills directories to ensure consistent frontmatter formatting and compliance.

Why does my Pi skill fail auto-discovery on agentskills.io?

Pi skills fail auto-discovery on agentskills.io due to common formatting mistakes like missing frontmatter fields, directory-name mismatches, or prohibited content patterns that block reliable loading into agent context.