{"id":"81eb9a1d-122a-4cb9-b488-6f554a21dd08","shortId":"JwF7ku","kind":"skill","title":"review-a-skill","tagline":"Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.","description":"# Review A Skill\n\n## Goal\n\nEvaluate a single skill's quality, relevance, and safety before it enters or stays in a library.\n\n## Guardrails\n\n- Always use `--format json` for machine-readable output in automated pipelines.\n- Always use `--fields` to limit output size when inspecting catalog entries.\n- Always use `--dry-run` before curating or removing a skill.\n- Never remove a skill without first checking if other skills depend on it via `info --format json` dependencies.\n\n## Workflow\n\n1. Preview the skill content to check for quality and safety.\n\n```bash\nnpx ai-agent-skills preview <skill-name>\n```\n\nThe preview command sanitizes content — if it flags sanitization, investigate before proceeding.\n\n2. Inspect the catalog entry for metadata completeness.\n\n```bash\nnpx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies\n```\n\n3. Validate the skill's SKILL.md structure.\n\n```bash\nnpx ai-agent-skills validate <skill-name>\n```\n\n4. If the skill needs curation (notes, collections, verification):\n\n```bash\nnpx ai-agent-skills curate <skill-name> --notes \"Reviewed: solid patterns\" --verify --dry-run\nnpx ai-agent-skills curate <skill-name> --notes \"Reviewed: solid patterns\" --verify\n```\n\n5. If the skill should be removed:\n\n```bash\nnpx ai-agent-skills curate <skill-name> --remove --dry-run\nnpx ai-agent-skills curate <skill-name> --remove --yes\n```\n\n## Decision Criteria\n\n- **Keep**: Clear description, valid frontmatter, useful to the library's audience, no injection patterns.\n- **Curate**: Needs better whyHere, collection placement, or verification status.\n- **Remove**: Duplicate, outdated, broken source, or contains suspicious content.\n\n## Gotchas\n\n- The `preview` command only works for vendored (house) skills. Upstream skills show description and whyHere only.\n- The `validate` command checks frontmatter structure but not content quality — that requires human or agent judgment.\n- Removing a skill that other skills depend on will break the dependency graph. Always check `dependencies.usedBy` first.","tags":["review","skill","agent","skills","moizibnyousaf","agent-skills","claude-code","cli","codex","cursor","developer-tools","productivity"],"capabilities":["skill","source-moizibnyousaf","skill-review-a-skill","topic-agent-skills","topic-claude-code","topic-cli","topic-codex","topic-cursor","topic-developer-tools","topic-productivity"],"categories":["Ai-Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/review-a-skill","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MoizIbnYousaf/Ai-Agent-Skills","source_repo":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1044 github stars · SKILL.md body (2,065 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:52:55.148Z","embedding":null,"createdAt":"2026-04-18T21:56:17.965Z","updatedAt":"2026-05-02T18:52:55.148Z","lastSeenAt":"2026-05-02T18:52:55.148Z","tsv":"'1':104 '2':134 '3':157 '4':171 '5':206 'agent':119,146,168,184,198,217,227,297 'ai':118,145,167,183,197,216,226 'ai-agent-skil':117,144,166,182,196,215,225 'alway':51,63,74,312 'audienc':244 'autom':61 'bash':115,142,164,180,213 'belong':11 'better':250 'break':308 'broken':260 'catalog':72,137 'check':17,91,110,286,313 'clear':235 'collect':155,178,252 'command':124,269,285 'complet':141 'contain':263 'content':16,108,126,265,291 'criteria':233 'curat':26,80,176,186,200,219,229,248 'decid':22 'decis':232 'depend':95,102,156,305,310 'dependencies.usedby':314 'descript':153,236,279 'dri':77,193,222 'dry-run':76,192,221 'duplic':258 'enter':44 'entri':73,138 'evalu':7,33 'field':65,151 'first':90,315 'flag':129 'format':53,100,149 'frontmatt':18,238,287 'goal':32 'gotcha':266 'graph':311 'guardrail':50 'hous':274 'human':295 'info':99,148 'inject':246 'inspect':71,135 'investig':131 'json':54,101,150 'judgment':298 'keep':25,234 'librari':14,49,242 'limit':67 'machin':57 'machine-read':56 'metadata':140 'name':152 'need':175,249 'never':85 'note':177,187,201 'npx':116,143,165,181,195,214,224 'outdat':259 'output':59,68 'pattern':190,204,247 'pipelin':62 'placement':253 'preview':15,105,121,123,268 'proceed':133 'qualiti':38,112,292 'readabl':58 'relev':39 'remov':28,82,86,212,220,230,257,299 'requir':294 'review':2,29,188,202 'review-a-skil':1 'run':78,194,223 'safeti':41,114 'sanit':125,130 'show':278 'singl':35 'size':69 'skill':4,10,31,36,84,88,94,107,120,147,160,169,174,185,199,209,218,228,275,277,301,304 'skill-review-a-skill' 'skill.md':162 'solid':189,203 'sourc':261 'source-moizibnyousaf' 'status':256 'stay':46 'structur':20,163,288 'suspici':264 'tag':154 'topic-agent-skills' 'topic-claude-code' 'topic-cli' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-productivity' 'upstream':276 'use':5,52,64,75,239 'valid':19,158,170,237,284 'vendor':273 'verif':179,255 'verifi':191,205 'via':98 'whether':8,23 'whyher':251,281 'without':89 'work':271 'workflow':103 'yes':231","prices":[{"id":"b3a98516-1b9e-4644-9d33-80fd1a56f8be","listingId":"81eb9a1d-122a-4cb9-b488-6f554a21dd08","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MoizIbnYousaf","category":"Ai-Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:56:17.965Z"}],"sources":[{"listingId":"81eb9a1d-122a-4cb9-b488-6f554a21dd08","source":"github","sourceId":"MoizIbnYousaf/Ai-Agent-Skills/review-a-skill","sourceUrl":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/review-a-skill","isPrimary":false,"firstSeenAt":"2026-04-18T21:56:17.965Z","lastSeenAt":"2026-05-02T18:52:55.148Z"}],"details":{"listingId":"81eb9a1d-122a-4cb9-b488-6f554a21dd08","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MoizIbnYousaf","slug":"review-a-skill","github":{"repo":"MoizIbnYousaf/Ai-Agent-Skills","stars":1044,"topics":["agent-skills","claude-code","cli","codex","cursor","developer-tools","productivity"],"license":"mit","html_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","pushed_at":"2026-04-13T19:04:12Z","description":"my curated agent skills library ","skill_md_sha":"168768bafbe672a449f8cce27c068faa66373bcb","skill_md_path":"skills/review-a-skill/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/review-a-skill"},"layout":"multi","source":"github","category":"Ai-Agent-Skills","frontmatter":{"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."},"skills_sh_url":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/review-a-skill"},"updatedAt":"2026-05-02T18:52:55.148Z"}}