Agent skill

Design

by vladikk in vladikk/modularity

Designs modular high-level architectures from functional requirements and produces design documents for each module.

Custom licenceAuto-check passedGame Development

Install Design

skills CLI
$ npx skills add vladikk/modularity --skill design -a claude-code

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

GitHub CLI
$ gh skill install vladikk/modularity 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/vladikk/modularity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/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
551
Token cost
~3.8k tokens
SKILL.md length
1,337 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Designs modular high-level architectures from functional requirements and produces design documents for each module.

  • Works in 6 steps: Understand the Requirements → Design the Modular Architecture → Write Module Design Documents → …
  • Designing a new system
  • SKILL.md covers Input, Interaction Rules, Process and Important Constraints
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design is an agent skill from vladikk/modularity. 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.

Its SKILL.md is about 3.8k 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 Game Development, covering Game design. The repository describes itself as: Claude Code plugin for designing modular systems from functional requirements and reviewing existing codebases for modularity problems with actionable improvement…

When your agent uses it

  • Designing a new system
  • Creating architecture documentation
  • Producing module-level design specs with integration contracts and test specifications

Example prompts

  • “Use the design skill to design modular high-level architectures from functional requirements and produces design documents for each module”
  • “/design”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, AskUserQuestion, TaskCreate, TaskUpdate

Workflow steps

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

  1. Understand the Requirements
  2. Design the Modular Architecture
  3. Write Module Design Documents
  4. Write Module Test Specifications
  5. Write the Architecture Document
  6. Modularity Review

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • AskUserQuestion
    • TaskCreate
    • TaskUpdate

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

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

  • Network

    No URLs in SKILL.md.

    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 3.8k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 1,337 words of instructions outside code blocks.

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

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 1,337 words (~3,776 tokens).

“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.”

— opening of SKILL.md by vladikk, Custom licence
name
design
allowed-tools
Read, Write, Edit, AskUserQuestion, TaskCreate, TaskUpdate
argument-hint
[path/to/functional-requirements.md]
skills
balanced-coupling

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/design of vladikk/modularity.

Open the folder on GitHubat commit bcdca9a

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 skillvladikk/modularity551—~3.8kAutomated safety check: PassCustom licence
Design Change PropagationDonchitos/Claude-Code-Game-Studios26k—~3.6kAutomated safety check: NotesMIT
Extraction TimingThibautBaissac/rails_ai_agents665—~1.2kAutomated safety check: PassMIT
Gm FinalizeRandallLiuXin/GodotMaker549—~3.7kAutomated safety check: PassCustom licence
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT

Similar skills

  • Design Change Propagation

    Donchitos/Claude-Code-Game-Studios

    Finds architecture decision records made stale by a changed game design document, then reports the impact and guides you through resolving each one.

    26k GitHub stars~3.6k tokensUpdated 9 days ago
    Game DevelopmentAuto-check: notes
  • Extraction Timing

    ThibautBaissac/rails_ai_agents

    Guides decisions about when and how to extract code into services, queries, concerns, form objects, or other patterns.

    665 GitHub stars~1.2k tokensUpdated 4 mo ago
    Game DevelopmentAuto-check passed
  • Gm Finalize

    RandallLiuXin/GodotMaker

    Seal the current tag: snapshot the per-tag working docs into docs/tags/<Tag/, write a CHANGELOG entry, run git tag, and reset per-tag runtime state for the next /gm-gdd round.

    549 GitHub stars~3.7k tokensUpdated 21 days ago
    Game DevelopmentAuto-check passed
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Game DevelopmentAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • Threejs Gameplay Systems

    corosolto/client

    Build and iterate playable Three.js game systems. An agent skill from corosolto/client.

    257 GitHub stars~1.5k tokensUpdated today
    Game DevelopmentAuto-check passed

More from vladikk/modularity

  • Document

    vladikk/modularity

    Produces modularity review documents in both Markdown and HTML formats.

    551 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Review

    vladikk/modularity

    Analyzes a codebase's modularity imbalances using the Balanced Coupling model and produces a review of design issues.

    551 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Balanced Coupling

    vladikk/modularity

    The Balanced Coupling model for software design. An agent skill from vladikk/modularity.

    551 GitHub stars~6.2k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Design

What does Design do?

Designs modular high-level architectures from functional requirements and produces design documents for each module. Design is an agent skill from vladikk/modularity. Designs modular high-level architectures from functional requirements and produces design documents for each module.

When should I use Design?

Design fits situations like: designing a new system; creating architecture documentation; producing module-level design specs with integration contracts and test specifications.

How do I install Design in Claude Code?

Run `npx skills add vladikk/modularity --skill design -a claude-code`. Or copy the skill folder (skills/design in vladikk/modularity) 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 vladikk/modularity --skill design -a codex`. Or copy the skill folder (skills/design in vladikk/modularity) 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 vladikk/modularity --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?

SKILL.md names no scripts, command-line tools or credentials: Design is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, AskUserQuestion, TaskCreate, TaskUpdate.

Does Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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 3.8k tokens (SKILL.md is roughly 15k 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: Design Change Propagation (Donchitos/Claude-Code-Game-Studios, 26k stars), Extraction Timing (ThibautBaissac/rails_ai_agents, 665 stars), Gm Finalize (RandallLiuXin/GodotMaker, 549 stars) and Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design?

vladikk (a GitHub user) maintains it in vladikk/modularity, which has 551 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 31, 2026.

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