Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code
Open on GitHub

What 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 utils and helpers dump 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-code

2Manually: put the files in place

~/.claude/skills/system-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/system-design/

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.

system-design official anthropics system-design walks you through designing services and systems: requirements, components, trade-offs. Useful when you need to decide how to split a service into parts. CX Codex +1 7,900installs system-design wondelai system-design — a skill that walks your agent through four design stages: requirements and scale, high-level diagram, capacity estimates, tradeoffs. Useful before you commit to an architecture. CX Codex +1 6,800installs system-design jwynia system-design diagnoses design problems and walks a solo developer from requirements to architecture, components and interfaces. CX Codex +1 661installs architect-review rmyndharis architect-review — a skill for Claude Code, Codex, Cursor, and other tools. Evaluates system architecture, scalability impacts, and distributed design patterns during major refactoring. CX Codex +1 154installs comprehensive-review-architect-review Seth Hobson comprehensive-review-architect-review is a subagent for Claude Code, Codex, and Cursor that reviews code and design decisions when assessing microservice boundaries, SOLID, and distributed-system patterns. CX Codex ★ 42,780repo stars design-code-architecture wondelai design-code-architecture — a skill for Claude Code, Cursor, and other platforms that walks you through eight architecture phases — from boundaries and domain model through data choices to resilience. CX Codex +1 2,700installs system-design-generator patricio0312rev system-design-generator turns product or feature requirements into architecture plans with components, data flows, API contracts, and scaling notes. Useful before implementation starts. CX Codex +1 284installs system-design-from-scratch dotslashsimran system-design-from-scratch — a skill for Claude Code that builds minimal distributed architectures, verifies invariants under simulated node failures, and stress-tests them with real metrics. CX Codex +1 ★ 541repo stars architecture-patterns Seth Hobson architecture-patterns guides backend architecture with Clean Architecture, Hexagonal Architecture, and DDD. Use it when designing a service, untangling a monolith, or tracing dependency cycles. CX Codex +1 24,144installs

From the same set42

The whole set →
financial-analysis-agent financial-analysis-agent helps build agents for fundamental stock evaluation and risk calculation. Practical for developing robo-advisors or investment trackers. CX Codex +1 1,300installs legal-document-analyzer The legal-document-analyzer skill reviews contracts, detects risks, and checks compliance. Use it when an agent must process PDF, DOCX, or plain-text legal documents. CX Codex +1 1,200installs ecommerce-platform-specialist ecommerce-platform-specialist — a skill that steers your agent through Shopify development: Admin API, Storefront API, Liquid themes, webhooks and checkout. CX Codex +1 660installs creative-generation-agent creative-generation-agent is a Claude Code skill with Python architecture and templates for agents that produce synthetic audio or digital artwork. It supports generative media pipeline assembly. CX Codex +1 575installs chat-with-arxiv chat-with-arxiv searches ArXiv preprints, parses PDF files, and generates answers with source citations. Designed for literature reviews and cross-paper synthesis. CX Codex +1 305installs deep-research-agent deep-research-agent is a Claude Code skill that automates data collection, source validation and report writing for market overviews, competitive analysis and academic literature reviews. CX Codex +1 290installs autonomous-agent-gaming autonomous-agent-gaming is a skill with runnable examples of rule-based, minimax, MCTS and Q-learning bots, plus a chess engine for agents choosing game moves. CX Codex +1 274installs rag-agent-builder rag-agent-builder provides templates and scripts to build RAG pipelines with vector databases, hybrid retrieval, and response evaluation. CX Codex +1 263installs

Project sponsors

Companies that keep this analytics open