system-design · qodex-ai — Claude Code skill: what it does, how to install
system-design enforces Clean Architecture and DDD standards for coding agents. Steers models away from reinventing common utilities.
LicenseRef-Proprietary 218 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-codeWhat system-design does
This skill configures the agent to follow domain-driven design and Clean Architecture patterns. It isolates business workflows from infrastructure layers, banning database queries in controllers and keeping UI components free of domain logic. Generic dump files like helpers.js or utils.js are prohibited in favor of explicit domain concepts such as InvoiceGenerator.
The guidelines mandate a library-first strategy. The model must check npm or existing services before drafting custom logic. For instance, retry loops should pull in existing packages like cockatiel instead of hand-rolled helpers. Writing custom routines is restricted to domain-specific business rules, critical performance paths, or strict security needs.
Stylistic constraints keep the codebase lean. Files longer than 200 lines must be split into separate modules, and individual functions should remain under 50 lines. Deep nesting is capped at three tiers. Keep in mind that this skill carries a proprietary license.
What it helps with
- isolate business workflows from infrastructure code
- prevent bloated
utilsandhelpersdump files - replace ad-hoc helper scripts with tested npm packages
- split overgrown files longer than 200 lines
Example prompts for the agent
- Design the billing module following domain-driven design guidelines.
- Review this controller and pull database queries out into separate use cases.
- Refactor our retry logic to use an established npm library instead of custom helpers.
How to install system-design
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code2Manually: put the files in place
~/.claude/skills/system-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/system-design/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a codex2Manually: put the files in place
.agents/skills/system-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a cursor2Manually: put the files in place
.cursor/skills/system-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/system-design2Manually: put the files in place
.github/skills/system-design/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/system-designManually: put the files in place
.devin/skills/system-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about system-design
How to install system-design in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code. The file will be written to ~/.claude/skills/system-design/SKILL.md.
What does the system-design skill do?
It instructs your AI agent to apply Clean Architecture, follow DDD naming habits, and select existing open-source libraries before writing custom code.
When does this skill permit writing custom code instead of using libraries?
Custom code is allowed for domain-specific business rules, performance-critical sections, sensitive security tasks, or when external dependencies do not meet requirements.
Similar skills
All skills for Backend and APIs →system-design by other authors comes first.