Agent skill

Design

by openwpm in openwpm/OpenWPM

A skill your agent uses to author or iterate a feature design document grounded in actual codebase exploration.

Custom licenceAuto-check passedDevelopment

Install Design

skills CLI
$ npx skills add openwpm/OpenWPM --skill design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openwpm/OpenWPM design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openwpm/OpenWPM.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/design .claude/skills/design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design
GitHub stars
1.4k
Token cost
~1.9k tokens
SKILL.md length
684 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses to author or iterate a feature design document grounded in actual codebase exploration.

  • Works in 4 steps: Explore & Interview (skip if --continue) → Draft → Resolve open questions (interactive) → …
  • Iterate a feature design document grounded in actual codebase exploration
  • SKILL.md covers Arguments, Phase 1: Explore & Interview…, Phase 2: Draft and Phase 3: Resolve open…, plus 6 more sections
  • Calls gh

What it does

Design is an agent skill from openwpm/OpenWPM. Use to author or iterate a feature design document grounded in actual codebase exploration. Drives a four-phase flow (Explore & Interview → Draft → Resolve open questions → Iterate) and writes .design/<slug.md plus a pipeline state file ready for crosslink kickoff --doc. Trigger when the user says "design <feature", "/design …", "iterate the design", or asks to write a design doc / spec / RFC for a feature.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records. The repository describes itself as: A web privacy measurement framework.

When your agent uses it

  • Iterate a feature design document grounded in actual codebase exploration
  • The user says design <feature
  • Iterate the design
  • Asks to write a design doc / spec / RFC for a feature

Example prompts

  • “design <feature”
  • “/design …”
  • “iterate the design”
  • “/design”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Explore & Interview (skip if --continue)
  2. Draft
  3. Resolve open questions (interactive)
  4. Iterate (when --continue is used)

What it can do on your machine

Read from SKILL.md and the folder at commit da628ba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design loads about 1.9k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 684 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 684 words (~1,859 tokens).

“You are an interactive design document author. You help the user go from a rough feature idea to a validated, codebase-grounded design document ready for crosslink kickoff --doc.”

— opening of SKILL.md by openwpm, Custom licence
name
design

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/design of openwpm/OpenWPM.

Open the folder on GitHubat commit da628ba

Compare with similar skills

Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design this skillopenwpm/OpenWPM1.4k—~1.9kAutomated safety check: PassCustom licence
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Cto AdvisorIbrahim-3d/orchestrator-supaconductor3804 repos~2.4kAutomated safety check: PassMIT
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Domain Modelingbrim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid1751 repos~5.6kAutomated safety check: PassNone

Similar skills

  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    380 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Improve Codebase Architecture

    ywwynm/EverythingDone

    Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

    144 GitHub starsUsed in 15 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Domain Modeling

    brim-borium/spotify_sdk

    Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

    166 GitHub starsUsed in 5 repos~806 tokens
    DevelopmentAuto-check passed
  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    175 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed
  • Learning Opportunities

    DrCatHicks/learning-opportunities

    Facilitates deliberate skill development during AI-assisted coding.

    2.5k GitHub stars~2.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from openwpm/OpenWPM

All 13 skills in this repo
  • Crosslink Guide

    openwpm/OpenWPM

    A skill your agent uses when working in any repo that has .crosslink/ and the workflow involves issue tracking, sessions, locks, swarms, kickoff, or knowledge pages.

    1.4k GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check passed
  • Audit

    openwpm/OpenWPM

    A skill your agent uses when stuck, confused, or disoriented in a crosslink-tracked project — dumps the full context (session state, active issue, locks, blockers, hook config, git state, project…

    1.4k GitHub stars~676 tokensUpdated 3 days ago
    Auto-check passed
  • Check

    openwpm/OpenWPM

    A skill your agent uses to check on background feature agents launched via /kickoff — running in tmux sessions or docker/podman containers.

    1.4k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Commit

    openwpm/OpenWPM

    A skill your agent uses to create a jj commit AND auto-document the result on the active crosslink issue.

    1.4k GitHub stars~669 tokensUpdated 3 days ago
    Auto-check passed
  • Featree

    openwpm/OpenWPM

    A skill your agent uses to create a feat/<slug bookmark AND spin up a new git worktree under <repo-root/.worktrees/<slug, then initialize crosslink hooks and an agent identity in the worktree so a…

    1.4k GitHub stars~846 tokensUpdated 3 days ago
    Auto-check passed
  • Feature

    openwpm/OpenWPM

    A skill your agent uses to create a feat/<slug branch from a human-readable description and register a matching crosslink issue (priority medium, label feature).

    1.4k GitHub stars~576 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Design

What does Design do?

A skill your agent uses to author or iterate a feature design document grounded in actual codebase exploration. Design is an agent skill from openwpm/OpenWPM. Use to author or iterate a feature design document grounded in actual codebase exploration.

When should I use Design?

Design fits situations like: iterate a feature design document grounded in actual codebase exploration; the user says design <feature; iterate the design; asks to write a design doc / spec / RFC for a feature.

How do I install Design in Claude Code?

Run `npx skills add openwpm/OpenWPM --skill design -a claude-code`. Or copy the skill folder (.claude/skills/design in openwpm/OpenWPM) into .claude/skills/design in your project. Claude Code loads it when a task matches its description.

How do I install Design in Codex?

Run `npx skills add openwpm/OpenWPM --skill design -a codex`. Or copy the skill folder (.claude/skills/design in openwpm/OpenWPM) into .agents/skills/design in your project. Codex loads it when a task matches its description.

Can I use Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openwpm/OpenWPM --skill design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design, .gemini/skills/design, .github/skills/design and .opencode/skills/design in your project.

What does Design need to run?

Going by SKILL.md and its folder, Design needs the command-line tools its instructions call (gh).

Does Design access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design use?

Design has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Design use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design?

Skills that share tags, products or a category with Design: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 380 stars), Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars) and Domain Modeling (brim-borium/spotify_sdk, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design?

openwpm (a GitHub organization) maintains it in openwpm/OpenWPM, which has 1,423 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 4, 2026.

Source: openwpm/OpenWPM on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.