review-a-skill

name	review-a-skill
description	Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.
category	workflow
version	4.1.0

Review A Skill

Goal

Evaluate a single skill's quality, relevance, and safety before it enters or stays in a library.

Guardrails

• Always use --format json for machine-readable output in automated pipelines.
• Always use --fields to limit output size when inspecting catalog entries.
• Always use --dry-run before curating or removing a skill.
• Never remove a skill without first checking if other skills depend on it via info --format json dependencies.

Workflow

1. Preview the skill content to check for quality and safety.

npx ai-agent-skills preview <skill-name>

The preview command sanitizes content — if it flags sanitization, investigate before proceeding.

2. Inspect the catalog entry for metadata completeness.

npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies

3. Validate the skill's SKILL.md structure.