Skill
ask-questions-if-under…
Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
@moizibnyousafView SkillDevelopment
Skill
/review-a-skill
Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.
Install
$ npx -y skills add MoizIbnYousaf/Ai-Agent-Skills --skill review-a-skill --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/review-a-skill
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.
SKILL.md
review-a-skill.SKILL.mdname: 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.
npx ai-agent-skills validate <skill-name>
4. 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
5. 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 `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.
Read more
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.
npx ai-agent-skills validate <skill-name>
4. 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
5. 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 `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.
Ships withai-agent-skills
Universal skill installer and package manager for AI coding agents. One command, 12+ runtimes. npx ai-agent-skills
Get the whole plugin
Stats
1,143
Stars
133
Forks
Maintained
Maintenance
JavaScript
Language
MIT
License
1mo ago
Last commit
9mo ago
Created
Repo: MoizIbnYousaf/Ai-Agent-Skills
Other skills on ai-agent-skills.
@moizibnyousafView SkillSkill
audit-library-health
Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
@moizibnyousafView SkillSkill
backend-development
Backend API design, database architecture, microservices patterns, and test-driven development. Use for designing APIs, database schemas, or backend system…
@moizibnyousafView SkillSkill
best-practices
Transforms vague prompts into optimized Claude Code prompts. Adds verification, specific context, constraints, and proper phasing. Invoke with /best-practices.
@moizibnyousafView SkillSkill
browse-and-evaluate
Use when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing. Always use --fields to limit output size and --dry-run…
@moizibnyousafView SkillSkill
build-workspace-docs
Use when regenerating README.md and WORK_AREAS.md in a managed library workspace. Always dry-run first to preview changes.
@moizibnyousafView Skill