skills.rest
albertdobmeyer
albertdobmeyerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-reviewer

Evaluate SKILL.md files for structural validity, quality scoring, and publish readiness.

2|1|Updated Mar 2, 2026
Search Tags:#publishing#audit#yaml#scoring#frontmatter#skill review
One-click install
npx skills add https://github.com/albertdobmeyer/opentrapp --skill skill-reviewer-albertdobmeyer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-reviewer
Source: https://github.com/albertdobmeyer/opentrapp/tree/main/workloads/skills/skills/skill-reviewer
Command: npx skills add https://github.com/albertdobmeyer/opentrapp --skill skill-reviewer-albertdobmeyer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you evaluate agent skills in a structured way so you can catch frontmatter errors, weak instructions, missing examples, and unsafe content before publishing or installing them.

Core Features & Use Cases

  • Structural validation: Checks whether a SKILL.md file has the required frontmatter fields and the expected layout.
  • Quality scoring: Reviews description strength, example density, organization, actionability, and tips quality using a clear rubric.
  • Defect detection: Flags broken commands, placeholder text, mismatched tool requirements, and other publishing blockers.
  • Use cases: Reviewing a new skill for a registry, auditing a downloaded skill, comparing two skills in the same category, or improving your own skill content.

Quick Start

Ask the assistant to review a skill-reviewer SKILL.md file for structure, content quality, actionability, and publish readiness.

Frequently Asked Questions about skill-reviewer

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

FAQPage Schema
How do I validate SKILL.md frontmatter before publishing an agent skill?▼

A skill audit evaluates SKILL.md frontmatter, checks required metadata fields, detects structural defects, and scores content quality using a rubric to ensure publish-readiness.

What does a skill review rubric check for in agent SKILL.md files?▼

A skill review rubric checks SKILL.md files for frontmatter completeness, description strength, example density, organization, actionability, and tips quality to identify publishing blockers.

How do I audit a downloaded agent skill for broken commands or missing examples?▼

You audit a downloaded agent skill by running a defect detection process that flags broken commands, placeholder text, mismatched tool requirements, and missing examples before installation.

Can I compare two agent skills in the same category to decide which one to install?▼

Yes, you can perform a comparative review of two agent skills in the same category by scoring both SKILL.md files against the same rubric and comparing their structural validity and content quality.

What are common publishing blockers found during a SKILL.md content review?▼

Common publishing blockers found during a SKILL.md review include missing frontmatter fields, broken commands, leftover placeholder text, mismatched tool requirements, and weak instructions.

Related Skills

Explore More Software Engineering Skills→
thevibeworksthevibeworks
28

template-skill

Create GitHub Skill directories with YAML frontmatter and instruction placeholders.

Official
Basic
gitgoodordietryinggitgoodordietrying
1

skill-reviewer

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

Community
Intermediate
imclabimclab
1

skill-test

Validate skill markdown files against structural and behavioral requirements.

Official
Advanced
WILLOSCARWILLOSCAR
497

rubric-writer

Generate a rubric-based peer review report from claims and evidence gaps.

Community
Intermediate