Authors codebase-grounded feature design documents through a four-phase interactive workflow.
npx skills add https://github.com/openwpm/OpenWPM --skill design-openwpm
Please help me install this Agent Skill. Skill: design Source: https://github.com/openwpm/OpenWPM/tree/main/.claude/skills/design Command: npx skills add https://github.com/openwpm/OpenWPM --skill design-openwpm
.design/<slug>.md with requirements, mechanically testable acceptance criteria, architecture notes, and tracked open questions. - Interactive Iteration & Validation: Resolves open questions conversationally, validates document quality, stores the doc as a knowledge page, and initializes a pipeline state file for crosslink kickoff. - Use Case: A developer says "design batch retry logic for sync" and receives a validated design doc grounded in the actual sync module, with unresolved decisions flagged as open questions. ## Quick Start Ask the assistant to design a feature, for example: design a document for adding batch retry logic to the sync module.High-intent search queries and answers about installing and using this skill.
Invoke the design skill with a quoted feature description. It explores the codebase, asks clarifying questions grounded in real files, then drafts a structured document with requirements, acceptance criteria, and architecture notes in .design/<slug>.md.
Pass --continue with the document slug, for example /design --continue add-batch-retry-logic. The skill reads the existing draft, detects unresolved open question blocks, and strengthens the document based on your answers.
Yes, pass --gh-issue <number> to read a GitHub issue via gh issue view, or --issue <id> to read a crosslink issue. The issue content informs the exploration and clarifying questions.
Unresolved ambiguities remain as <!-- OPEN --> blocks in the document, which is still valid but flagged during validation. You can resolve them interactively in a later iteration or edit the file directly.
No, it only writes files under .design/ and never modifies source code. It suggests next steps like crosslink kickoff but does not run planning or implementation commands automatically.
tsmesWrite accurate, minimal documentation for code, features, and systems.
kitfunsoGenerate PRD, Architecture, CLAUDE.md, and Plan documents from frontmatter metadata.
maystudiosStore and retrieve project learnings and decisions using GitHub Issues.
ArtRivExecute small ad-hoc tasks with atomic commits and STATE.md tracking.