prompt-review

Audit prompt files and Skill definitions for YAML frontmatter and output structure.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/yuch4/dx-selecta --skill prompt-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-review
Source: https://github.com/yuch4/dx-selecta/tree/main/.github/skills/prompt-review
Command: npx skills add https://github.com/yuch4/dx-selecta --skill prompt-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Skill helps teams audit and improve prompt files and Skill definitions to ensure YAML frontmatter validity, well-designed inputs, fixed output structures, and clear references, reducing duplication and risky prompts.

Core Features & Use Cases

  • Frontmatter validation and naming checks
  • Input variable design guidance and reuse encouragement
  • Output format stabilization and reporting
  • Duplication control by centralizing rules in skills and references
  • Safe tooling guidance with minimal external actions

Quick Start

Use the prompt-review skill to scan .github/prompts and generate or update docs/prompt-review-report.md.

Frequently Asked Questions about prompt-review

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

FAQPage Schema
How do I validate YAML frontmatter in prompt files?

YAML frontmatter validation checks that prompt files under .github/prompts contain required name and description fields. This skill audits those files, verifies input variables, and generates a report documenting any structural or metadata inconsistencies found.

What's the best way to ensure consistent prompt output structure?

Ensuring consistent prompt output structure involves checking that each Skill definition enforces a fixed, well-structured output format. This skill audits prompts to stabilize outputs, validate input variables, and centralize rules to prevent duplication and unreliable responses.

How do I audit prompts for safety and risky instructions?

Auditing prompts for safety involves scanning prompt files and Skill definitions for risky instructions and unnecessary external actions. This skill reviews those prompts, provides safe tooling guidance, and reports potential safety concerns in a consolidated markdown report.

Do I need a specific framework to check prompt consistency across a project?

No specific framework is required to check prompt consistency. This skill operates directly on .github/prompts directories and SKILL.md files, requiring no external dependencies to validate frontmatter, check naming conventions, and ensure consistent output structures.

Why does my prompt review report show missing input variables?

A prompt review report shows missing input variables when SKILL.md frontmatter lacks proper variable definitions or validation. This skill identifies these gaps during its audit, ensuring all input variables are designed clearly and reused properly to maintain prompt reliability.