reviewing-pi-skills

Review Pi skills for quality, spec compliance, and token efficiency.

Updated Feb 14, 2026

Search Tags:#documentation #quality-assurance #frontmatter #token-efficiency #spec-compliance #skill-review

Ready to run

npx skills add https://github.com/jbro/pi-agent --skill reviewing-pi-skills

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reviewing-pi-skills
Source: https://github.com/jbro/pi-agent/tree/main/skills/pi-skills/reviewing-pi-skills
Command: npx skills add https://github.com/jbro/pi-agent --skill reviewing-pi-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews a Pi skill to ensure it meets quality, spec compliance, and token efficiency requirements, producing a structured report and offering an optimized rewrite when requested or when verbose.

Core Features & Use Cases

Systematic quality checks across name, description, and safety rules.
Output a standardized, structured report with actionable recommendations.
Optional rewrite to improve clarity and conciseness for long-form SKILL.md content.

Quick Start

Review a target skill by loading its SKILL.md and related files, then generate a structured quality report.

Frequently Asked Questions about reviewing-pi-skills

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

FAQPage Schema

How do I check documentation quality and spec compliance for my Pi skills?▼

You can check Pi skill documentation quality and spec compliance by loading the target SKILL.md to validate frontmatter naming, description accuracy, and safety rules, producing a structured report with actionable recommendations.

What is token efficiency and how is it measured in skill reviews?▼

Token efficiency in skill reviews measures how concisely a SKILL.md conveys instructions without unnecessary verbosity. The review evaluates this metric and offers an optional rewrite to improve clarity and reduce token consumption.

How do I validate frontmatter name and description fields in a SKILL.md file?▼

Validate frontmatter name and description fields in a SKILL.md file by applying a systematic quality check that scans for blockers and confirms required metadata exists, outputting a structured compliance report detailing missing or invalid entries.

Can I get an optimized rewrite of my SKILL.md content during a quality review?▼

Yes, you can get an optimized rewrite of your SKILL.md content during a quality review. The process outputs an optional rewrite to improve clarity and conciseness for long-form content when requested or running in verbose mode.

What are the limitations when reviewing Pi skills for safety rules and blockers?▼

A key limitation when reviewing Pi skills for safety rules is that the process requires frontmatter name and description fields present in the SKILL.md. The review checks for blockers across modules but does not generate new safety rules.