Review A Skill
Testing & Qualityreview-a-skillReview A Skill is an Agent Skill for testing & quality published in the MoizIbnYousaf/Ai-Agent-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/MoizIbnYousaf/Ai-Agent-Skills/blob/HEAD/skills/review-a-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/review-a-skill, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 jsonfor machine-readable output in automated pipelines. - Always use
--fieldsto limit output size when inspecting catalog entries. - Always use
--dry-runbefore curating or removing a skill. - Never remove a skill without first checking if other skills depend on it via
info --format jsondependencies.
Workflow
- 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.
- Inspect the catalog entry for metadata completeness.
npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies
- Validate the skill's SKILL.md structure.
npx ai-agent-skills validate <skill-name>
- If the skill needs curation (notes, collections, verification):
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify --dry-run
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify
- If the skill should be removed:
npx ai-agent-skills curate <skill-name> --remove --dry-run
npx ai-agent-skills curate <skill-name> --remove --yes
Decision Criteria
- Keep: Clear description, valid frontmatter, useful to the library's audience, no injection patterns.
- Curate: Needs better whyHere, collection placement, or verification status.
- Remove: Duplicate, outdated, broken source, or contains suspicious content.
Gotchas
- The
previewcommand only works for vendored (house) skills. Upstream skills show description and whyHere only. - The
validatecommand checks frontmatter structure but not content quality — that requires human or agent judgment. - Removing a skill that other skills depend on will break the dependency graph. Always check
dependencies.usedByfirst.