Skip to main content
skill CX Codex

review-a-skill — Claude Code skill: review and install

review-a-skill reviews a skill before it enters a library by checking metadata, structure, safety, and dependencies. Use it when the choice is keep, curate, or remove.

MIT 177 installs ★ 1,161 updated 2026-09-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MoizIbnYousaf/ai-agent-skills --skill review-a-skill -a claude-code
Open on GitHub

What review-a-skill does

This skill guides a review of one library entry. It previews the content with npx ai-agent-skills preview <skill-name>, inspects selected catalog fields as JSON, validates the SKILL.md frontmatter structure, and supports a keep, curate, or remove decision. Automated pipelines should use --format json and narrow catalog output with --fields.

Changes start with --dry-run. Before removal, inspect dependencies with info --format json, including dependencies.usedBy; removing a skill used by others breaks the dependency graph. The preview command fully works only for vendored skills, while validate checks frontmatter structure rather than content quality.

What it helps with

  • inspect a skill for suspicious instructions
  • check catalog metadata and frontmatter
  • validate the SKILL.md structure
  • choose whether to keep, curate, or remove a skill

Example prompts for the agent

  • Review my-skill before adding it to the library.
  • Show my-skill metadata as JSON and inspect its dependencies.
  • Run a dry removal for my-skill, then check dependencies.usedBy.

How to install review-a-skill

1Skills CLI (Vercel)

npx skills add MoizIbnYousaf/ai-agent-skills --skill review-a-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/review-a-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/review-a-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about review-a-skill

How do I install review-a-skill in Claude Code?

Run npx skills add MoizIbnYousaf/ai-agent-skills --skill review-a-skill -a claude-code, then use ~/.claude/skills/review-a-skill/SKILL.md.

What does review-a-skill do?

It previews a skill, checks catalog metadata and SKILL.md structure, then supports a keep, curate, or remove decision.

What should I check before removing a skill?

Inspect dependencies with info --format json and review dependencies.usedBy. Removing a skill that other skills use breaks the dependency graph.

Source text

SKILL.md · MIT
---
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.

```bash
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.

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

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

```bash
npx ai-agent-skills validate <skill-name>
```

4. If the skill needs curation (notes, collections, verification):

```bash
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
```

5. If the skill should be removed:

```bash
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 `preview` command only works for vendored (house) skills. Upstream skills show description and whyHere only.
- The `validate` command 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.usedBy` first.

© MoizIbnYousaf · MIT · MoizIbnYousaf/ai-agent-skills

Similar skills

All skills for Code review and refactoring →

From the same set15

The whole set →
best-practices best-practices transforms vague instructions into detailed coding prompts with verification steps, file context, and explicit constraints. Useful for complex implementation tasks. CX Codex +1 533installs llm-application-dev llm-application-dev is a Claude Code skill for building with large language models across coding platforms. It includes prompt templates, API integration, RAG patterns, and error handling. CX Codex +1 467installs ask-questions-if-underspecified The ask-questions-if-underspecified skill makes the agent ask 1–5 clarifying questions before it starts work, so you don't get the wrong thing built. Invoked manually. CX Codex +1 383installs browse-and-evaluate The browse-and-evaluate skill helps you find, compare, and inspect catalog skills before adding them. Use it when catalog output needs to stay focused. CX Codex +1 177installs build-workspace-docs build-workspace-docs keeps README.md and WORK_AREAS.md aligned with a skills catalog. Run it after catalog changes or before committing workspace updates. CX Codex +1 172installs audit-library-health audit-library-health — a skill for diagnosing a skills library: validates structure, finds stale elements, checks documentation sync. Run before publishing or updating. CX Codex +1 170installs update-installed-skills update-installed-skills syncs previously installed agent skills to their upstream versions. Helps you inspect changes safely with dry-run flags before overwriting local setups. CX Codex +1 168installs share-a-library share-a-library — a skill that automates publishing a finished local library to GitHub and generates an install command for your teammates. CX Codex +1 161installs

Project sponsors

Companies that keep this analytics open