Review a Design

Review a Design is a Quality skill for Claude Code, published by inkeep in open-knowledge.

3.5K stars219 forkson inkeep/open-knowledgeAdded 2026/08/16+1% in starsRepository updated 2026/08/16

2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills

Install in seconds

Install Review a Design

Copy Review a Design into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/inkeep/open-knowledge/tree/main/packages/server/assets/skills/packs/software-lifecycle/review-a-design ~/.claude/skills/review-a-design

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/inkeep/open-knowledge.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: packages/server/assets/skills/packs/software-lifecycle/review-a-design/SKILL.md in inkeep/open-knowledge
Installs to: ~/.claude/skills/review-a-design
Collection: One of 18 skills cataloged from this repository
Category: Quality — 1354 skills

What Review a Design does

Review a Design evaluates whether a design is sound—solving the right problem and following from its stated goals and constraints—and returns ranked, evidence-backed findings, not edits. Use it to pressure-test proposals, specs, ADRs, or architecture decisions before committing to them.

Review a Design is cataloged under Quality on DirSkills. Review a Design comes from a repository tagged 2nd-brain, agent-skills, claude, codex and company-brain.

Documentation

README

Excerpt

Review a design — is it sound, not just complete

The platform /open-knowledge skill still governs every markdown operation here (reads via exec, writes via write/edit, links as plain relative markdown, MCP owns in-scope .md); this skill layers design-review craft on top of it.

Three reviews are not the same review, and only one is this skill's job.

Completeness review asks: is every section filled in? (Are Drawbacks and Alternatives non-empty?)
Correctness review asks: are the individual claims true? (Does the benchmark really say 40ms? Is that API deprecated?)
Soundness review asks: should this be built at all, and is this the design that follows from the stated goals and constraints?

This is the opening of the README. Read the full README on GitHub.

Commands Review a Design provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/open-knowledge
/frame-a-proposal
/write-a-spec
/record-a-decision

Frequently asked about Review a Design

What else does inkeep publish alongside Review a Design?
Review a Design is one of 18 skills that DirSkills catalogs from inkeep/open-knowledge, the repository it ships in. Its siblings there include Codebase Wiki, Consolidate Notes and Frame a Proposal. Each one is a separate skill with its own page in this directory, installs the same way Review a Design does, and is maintained by inkeep in that same repository. The rest of the collection is listed on the inkeep/open-knowledge page.
How does Review a Design compare to other Quality skills?
Review a Design ranks #391 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Review a Design against them. Open each page to compare what they document and how they install.