design

Design software architecture, API contracts, and data flows for Python projects.

25|2|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/matteocervelli/llms --skill design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/matteocervelli/llms/tree/main/.claude/skills/design
Command: npx skills add https://github.com/matteocervelli/llms --skill design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill eliminates ambiguity and rework by systematically translating complex requirements into clear, actionable technical designs for software architecture, API contracts, and data flows.

Core Features & Use Cases

  • System Architecture: Choose and define appropriate architectural patterns (e.g., Layered, Modular, Microservices) for new features, ensuring scalability and maintainability.
  • API & Data Model Design: Specify precise API contracts (REST, internal functions) and robust data structures (Pydantic schemas) with validation rules.
  • Workflow Planning: Map data flows and module interactions using sequence diagrams to ensure cohesive system behavior and error handling.
  • Use Case: After analyzing a new user authentication feature, use this skill to design the database schema, API endpoints, and service interactions, generating a comprehensive architecture document before any code is written.

Quick Start

Design the architecture for a new user profile management feature, including data models, API endpoints, and module interactions.

Frequently Asked Questions about design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a system architecture and API contracts before writing code?

System architecture design translates requirements into concrete technical designs by defining architectural patterns, API contracts, and data flows. This Skill systematizes that process, generating architecture documents with component definitions, REST API specifications, and Pydantic data models before implementation begins, reducing ambiguity and rework.

What's the best way to structure data models and API endpoints for a new feature?

Structure data models using Pydantic schemas with validation rules and design REST API endpoints that follow RESTful patterns. This Skill enforces modular boundaries, single-responsibility principle, and component interaction through sequence diagrams, ensuring cohesive API and data model design aligned with your feature requirements.

How do I map data flows and module interactions in my software design?

Map data flows and module interactions by defining workflow sequences and component dependencies through diagrams and specifications. This Skill generates data-flow diagrams and sequence diagrams that document end-to-end system behavior, error handling, and module interactions for comprehensive architecture documentation.

Can I use this for designing microservices or layered architecture patterns?

Yes, this Skill applies to multiple architectural patterns including layered, modular, and microservices approaches. It helps you choose and define the appropriate pattern for your feature, ensuring scalability and maintainability while enforcing dependency injection and modular boundaries across Python projects.

What technical requirements does this design process enforce?

The design process enforces dependency injection, modular boundaries, single-responsibility principle, file size limits of 500 lines maximum, Pydantic data models, RESTful API patterns, error handling strategies, and documentation standards to ensure production-ready architecture before implementation.

Do I need to analyze requirements before using this design skill?

Yes, this Skill works downstream of requirements analysis. Input analyzed requirements and this Skill translates them into actionable technical designs including architecture patterns, API contracts, data models, and workflow diagrams for end-to-end implementation planning.