skill-reviewer

Audit SKILL.md files for frontmatter validity and structural completeness.

1|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/gitgoodordietrying/moltbook-app --skill skill-reviewer-gitgoodordietrying
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-reviewer
Source: https://github.com/gitgoodordietrying/moltbook-app/tree/main/skills/skill-reviewer
Command: npx skills add https://github.com/gitgoodordietrying/moltbook-app --skill skill-reviewer-gitgoodordietrying

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured framework to audit and critique SKILL.md files for quality, correctness, and effectiveness, enabling reviewers to identify defects and suggest improvements before publishing.

Core Features & Use Cases

  • Structural checks: validate YAML frontmatter, required fields, and content sections.
  • Frontmatter quality: assess slug validity, non-empty description, and presence of metadata.
  • Defect detection: surface missing sections, placeholder values, inconsistent formatting, or outdated content.
  • Improvement guidance: generate actionable recommendations to raise skill quality to publish-ready standards.
  • Cross-skill comparisons: compare multiple SKILL.md files for coverage, clarity, and organization.
  • Audit workflow automation: integrate with registry tooling to automate reviews before publish.

Quick Start

Run the Skill Reviewer on a target SKILL.md file to generate a structural and content quality assessment.

Frequently Asked Questions about skill-reviewer

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

FAQPage Schema
How do I audit a SKILL.md file for structural completeness and frontmatter validity?

To audit a SKILL.md file, validate its YAML frontmatter for required fields, check slug validity, ensure descriptions are non-empty, and surface missing content sections to produce actionable quality improvement recommendations.

What is the best way to review agent skills for quality and correctness before publishing?

Reviewing agent skills before publishing involves applying a structured framework to detect defects like placeholder values or inconsistent formatting, ensuring content coverage, and generating actionable improvement guidance for publish-ready standards.

How do I detect missing sections and placeholder values in markdown documentation?

Detecting missing sections and placeholder values in markdown documentation requires a structural review process that scans the file to surface inconsistencies, outdated content, and incomplete formatting automatically.

Can I automate the review workflow for markdown skill files in a registry?

Automating the review workflow for markdown skill files is supported by integrating the audit framework with registry tooling, enabling automated structural checks and quality assessments before publishing.

What limitations exist when generating improvement recommendations for skill metadata?

Generating improvement recommendations for skill metadata focuses on structural completeness and frontmatter quality, but relies on the existing content within the SKILL.md file without adding new external domain knowledge.