Agent skill · Testing & QA

design

Designs modular high-level architectures from functional requirements and produces design documents for each module. Use when designing a new system, creating architecture documentation, or producing module-level design specs with integration contracts and test specifications.

vladikkgithub.com/vladikkGitHub ↗
claude-codecan modify filesNOASSERTION
Install
npx skills add vladikk/modularity --skill design --agent claude-code

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

Facts
Files in the skill folder: 1
SKILL.md size: 15 KB
Bundled scripts: none
Allowed tools: ReadWriteEditAskUserQuestionTaskCreateTaskUpdate
Path: skills/design/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 502
Language: HTML

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

From the SKILL.md

# High-Level Design You design modular high-level architectures from functional requirements and produce comprehensive design documentation. You apply the Balanced Coupling model (preloaded from the balanced-coupling skill) to all architectural decisions. ## Input If `$ARGUMENTS` contains a file path, read that file as the functional requirements input. If `$ARGUMENTS` is empty or not a valid file path, use `AskUserQuestion` to request it. Header: "Requirements". Question: "Please provide the path to the functional requirements file." Do not proceed until you have a valid file path and can successfully read the file. Use TaskCreate to track these 6 steps: Understand the Requirements, Design the Modular Architecture, Write Module Design Documents, Write Module Test Specifications, Write the Architecture Document, Modularity Review. ## Interaction Rules Always use `AskUserQuestion` for user input. Follow these principles: - **One question at a time.** Never batch multiple questions into one message. - **Multiple choice preferred.** Provide 2-4 concrete options with descriptions. Easier to answer than open-ended. - **"Other" is automatic.** The tool always provides a free-text "Other"

What's inside
Steps it walks through
  1. Input
  2. Interaction Rules
  3. Process
  4. Step 1: Understand the Requirements
  5. Step 2: Design the Modular Architecture
  6. Step 3: Write Module Design Documents
  7. Step 4: Write Module Test Specifications
  8. Step 5: Write the Architecture Document
  9. Step 6: Modularity Review
  10. Important Constraints
More from modularity
All skills →
About this skill
What does the design skill do?

Designs modular high-level architectures from functional requirements and produces design documents for each module. Use when designing a new system, creating architecture documentation, or producing module-level design specs with integration contracts and test specifications.

How do I install it?

Run `npx skills add vladikk/modularity --skill 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 vladikk/modularity, a repository with 502 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