Agent skill · Code Review & Quality

dev-design

AI DevKit · Design phase guidance for reviewing feature design against requirements. Use when the user wants to validate architecture, review design docs, resolve design trade-offs, or run dev-lifecycle phase 3.

Hoang Nguyen1,568★ · +5/wk · 1 repos on radarProfile →
claude-codecodexcursor
Install
npx skills add codeaholicguy/ai-devkit --skill dev-design --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 3 KB
Bundled scripts: none
Path: skills/dev-design/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,572 · +4 this week
Language: TypeScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Dev Design Run the design review phase for configured AI docs features. Before changing docs or code, propose the concrete plan for this phase and wait for user approval unless the user already approved the exact phase plan. ## Phase Contract 1. Run `npx ai-devkit@latest lint` before phase work. 2. If working on a named feature, run `npx ai-devkit@latest lint --feature <name>`. 3. Read existing requirements and design docs before changes. 4. Ask until every material architecture, scope, validation, rollout, contradiction, trade-off, or open question is answered, explicitly deferred, or accepted as a named assumption. 5. Ask one decision at a time, with why it matters, 2-3 viable options when useful, and a recommended answer. 6. Do not approve or transition past design while material open questions remain. 7. Use mermaid diagrams for architecture visuals where a diagram clarifies the design. 8. If parent `dev-lifecycle` established usable task tracing, emit design phase, progress, blocker/open-question, and next-step events per `task`. ## Review Design Use for Phase 3. 1. Run `npx ai-devkit@latest lint --feature <name>` and review the design doc path it validates. If manual path r

What's inside
Steps it walks through
  1. Phase Contract
  2. Review Design
Ships with 1 file
  • agents/openai.yaml
More from ai-devkit
All skills →
About this skill
What does the dev-design skill do?

AI DevKit · Design phase guidance for reviewing feature design against requirements. Use when the user wants to validate architecture, review design docs, resolve design trade-offs, or run dev-lifecycle phase 3.

How do I install it?

Run `npx skills add codeaholicguy/ai-devkit --skill dev-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From codeaholicguy/ai-devkit, a repository with 1,572 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going