skills.rest
y-miyazaki
y-miyazakiCOMMUNITY
Explore all skills by this author →
GitHub

instructions-review

Validate .github/instructions/*.instructions.md files against a four-chapter structure.

1|Updated Dec 8, 2025
Search Tags:#documentation#consistency#quality-checks#front-matter#instruction-review#four-chapter
One-click install
npx skills add https://github.com/y-miyazaki/arc --skill instructions-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: instructions-review
Source: https://github.com/y-miyazaki/arc/tree/main/.github/skills/instructions-review
Command: npx skills add https://github.com/y-miyazaki/arc --skill instructions-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates .github/instructions/*.instructions.md to ensure consistent structure, complete front matter, and cross-file coherence, reducing manual review time.

Core Features & Use Cases

  • Enforces 4-chapter structure: Standards → Guidelines → Testing and Validation → Security Guidelines, ensuring standardized documentation practices.
  • Front Matter Validation: Checks for required fields like name and description to enable reliable discovery and automation.
  • PR & Governance Tool: Useful for pull request reviews, repo audits, and contributor onboarding to maintain quality across instructions.
  • Issue Detection & Reporting: Generates a structured report of gaps and recommended fixes to streamline remediation.

Quick Start

Run the Instructions Review on the target repository to generate a compliance report for instruction files.

Frequently Asked Questions about instructions-review

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

FAQPage Schema
How do I validate instruction files for a consistent four-chapter structure?▼

To validate instruction files, this Skill checks that each .instructions.md file conforms to the Standards, Guidelines, Testing and Validation, and Security Guidelines chapter layout, flagging any structural gaps for remediation.

Can I automate instruction file quality checks during a pull request review?▼

Yes, you can automate instruction file quality checks during pull request reviews by running this Skill to generate a structured compliance report, ensuring new contributions meet front matter and chapter layout requirements.

What front matter requirements are enforced for .instructions.md files?▼

The front matter validation enforces required fields like name and description to enable reliable discovery and automation, ensuring all instruction files contain the necessary metadata for consistent repository governance.

How do I audit multiple instruction templates for onboarding workflows?▼

You can audit multiple instruction templates for onboarding workflows by running this Skill across the repository, which validates cross-file coherence and generates a report of gaps and recommended fixes.

Does the instruction review check for optional resource directories?▼

Yes, the instruction review checks for optional resource directories while validating the four-chapter standard, ensuring complete documentation practices and flagging missing elements for remediation.

What is the best way to ensure consistent documentation practices across instruction files?▼

The best way to ensure consistent documentation practices is to enforce a standardized four-chapter layout and front matter validation across all instruction files, reducing manual review time and maintaining cross-file coherence.

Related Skills

Explore More Content & Communication Skills→
alekspetrovalekspetrov
196

plugin-slash-command

Generates validated Navigator slash command Markdown files with YAML frontmatter and kebab-case naming.

Community
Intermediate
williamzujkowskiwilliamzujkowski
17

missing-level1

Detect missing Level 1 sections in Skill Unit documentation with YAML front matter.

Community
Basic
lanejlanej
40

acli

Automates Git and GitHub workflows including commits, branches, pull requests, and gh CLI tasks.

Community
Intermediate
jasonkneenjasonkneen
734

create-steering-documents

Generate project steering documents with YAML front-matter and inclusion rules.

Community
Intermediate