agent-skills-review

Reviews SKILL.md files for structural requirements, quality standards, and design patterns.

4|Updated May 29, 2020
One-click install
npx skills add https://github.com/y-miyazaki/go-common --skill agent-skills-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-skills-review
Source: https://github.com/y-miyazaki/go-common/tree/main/.github/skills/agent-skills-review
Command: npx skills add https://github.com/y-miyazaki/go-common --skill agent-skills-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the review process for SKILL.md files, ensuring they meet structural requirements, quality standards, and design patterns, thereby improving the overall quality and consistency of agent skills.

Core Features & Use Cases

  • Automated Structure Validation: Checks for mandatory sections, YAML fields, and correct file structure.
  • Manual Quality Assessment: Guides human or AI reviewers through systematic checks for clarity, determinism, and scope.
  • Design Pattern Compliance: Verifies adherence to established agent skill design principles.
  • Use Case: When a new agent skill is proposed, use this Skill to perform a thorough review of its SKILL.md file before merging, catching potential issues early.

Quick Start

Use the agent-skills-review skill to review the file '.github/skills/my-new-skill/SKILL.md'.

Frequently Asked Questions about agent-skills-review

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

FAQPage Schema
How do I validate SKILL.md metadata and structure for agent skills?

To validate SKILL.md metadata, review the file against structural requirements and mandatory YAML fields. This ensures agent skills meet quality standards and specification completeness before merging.

What is the best way to review SKILL.md files for design pattern compliance?

The best way to review SKILL.md files for design pattern compliance is using a defined review checklist. This verifies adherence to established agent skill design principles and evaluates implementation feasibility.

Can I use an automated checklist to check agent skills documentation quality?

Yes, you can use an automated checklist to check agent skills documentation quality. It guides reviewers through systematic checks for clarity, determinism, and scope within the .github/skills/ directory.

When do I need to perform a metadata validation check on agent skills?

You need to perform a metadata validation check when a new agent skill is proposed. Reviewing the SKILL.md file before merging catches potential structural and quality issues early.

Does the agent skills review process require any external dependencies?

No, the agent skills review process requires no external dependencies. It operates as a standalone skill utilizing scripts and references to evaluate SKILL.md files against a defined review checklist.