What is the primary output of the Design skill?

The skill generates a comprehensive architecture-doc.md file that includes architectural patterns, component designs, data models, API specs, and testing strategies.

Does this skill only work for Python projects?

While the examples and data modeling templates are optimized for Python and Pydantic, the architectural principles and REST API design patterns are applicable to any programming language.

How does it handle API documentation?

It provides templates for defining RESTful resources, HTTP methods, request/response schemas, and standardized error response formats.

At what stage of development should I use the Design skill?

It is designed to be used after requirements analysis is complete but before implementation begins, ensuring a clear technical roadmap is in place.

System Architecture & API Design

Name: System Architecture & API Design
Author: matteocervelli

bymatteocervelli

•

API Development

Designs robust software architecture, API contracts, and data models to bridge the gap between requirements and implementation.

This skill provides a systematic framework for translating analyzed requirements into actionable technical designs, covering everything from high-level architectural patterns to detailed Pydantic data models. It guides the user through creating API contracts, sequence diagrams, and module structures, ensuring that Claude produces consistent, well-organized, and testable codebases. By standardizing the design phase, it helps developers maintain high architectural standards and clear documentation before beginning any implementation.

Key Features

01Pydantic-based data model definition with validation and relationship mapping

0215 GitHub stars

03Architectural pattern selection including Layered, Modular, and Event-Driven systems

04Standardized RESTful and internal API contract specification

05Data flow mapping using sequence diagram logic for complex workflows

06Module boundary and dependency injection design for improved testability

Use Cases

01Standardizing API contracts and error handling hierarchies across a project

02Designing complex data models and validation logic using Pydantic schemas

03Defining technical architecture and module boundaries for new feature implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add matteocervelli/llms design

For use in Claude.ai and ChatGPT

Download Skill