skill-spec-review
Skill spec review
Review a skill package before merge or publish to skills.sh.
When to use
- "Review this skill"
- "Is this SKILL.md valid?"
- PR touches
skills/*/SKILL.md - Preparing a repo for
npx skills add
Review checklist
Structure
- Directory name is
kebab-caseand matchesnamein frontmatter - File is exactly
SKILL.md(case-sensitive) - No
README.mdinside the skill folder (usereferences/)
More from arenukvern/skill_steward
adr-records
Writes and maintains ADRs (MADR, Nygard, Y-Statement) and runs decision checkpoints before/during work—trigger matrix, option briefs, proposed ADRs. Use when creating or updating ADRs, facing a design fork, trade-off, boundary change, or when the user asks for key design decisions before implementing.
1faq-driven-docs
Creates and maintains DESIGN_FAQ (why) and DX_FAQ (how) documentation in FAQ-driven development style. Use when writing docs, rules, prompts, updating FAQs after code changes, or bootstrapping faq_usage rules and Cursor commands.
1create-skill
Scaffold a new Agent Skill in this marketplace repo with valid SKILL.md, directory layout, and registry entries. Use when adding a skill, creating SKILL.md, or contributing to skill_steward.
1skill-source-citations
Requires durable citations when authoring or researching Agent Skills—maintain references/sources.md per skill, link external research, and record provenance in PRs. Use when creating skills, updating SKILL.md, doing web research for skills, or auditing missing sources.
1concept-doc-store
Bootstraps and maintains a vectorless, layered documentation store for concepts, architecture, and decisions—without duplicating how code works. Use when organizing repo docs, writing ADRs, north-star charters, agent playbooks, or product-style doc lattices.
1multi-agent-handoff
Plan and document handoffs between specialized AI agents (foreman, workers, reviewers). Use for multi-agent workflows, subagent delegation, baton passes, or guild-style agent coordination.
1