What kind of output does this skill produce?

It generates a standardized Markdown design document in your docs/ directory, featuring technical specs, Mermaid diagrams, and a detailed implementation plan.

Is it possible to skip specific design rounds like Security or Infrastructure?

Yes, the skill is adaptive. You can tell the architect to skip specific sections, and it will note them as TBDs in the final document while moving on to the next topic.

Can the Design skill see my existing project files?

Absolutely. It performs a codebase survey to identify your current languages, frameworks, and architecture patterns so the new design integrates seamlessly.

Does this skill require an existing PRD to function?

Yes, a Product Requirements Document (PRD) is required. The skill will search your docs folder for existing PRDs or prompt you to create one before starting the design process.

Technical Design Architect

Name: Technical Design Architect
Author: ryanismert

byryanismert

0•

Learning & Documentation

Transforms product requirements into comprehensive technical design documents through structured architectural analysis and codebase exploration.

The Technical Design Architect skill bridges the gap between product vision and code implementation by acting as a senior software architect. It guides users through an iterative, six-phase design process that covers system architecture, data modeling, API design, and infrastructure scaling. By scanning your existing codebase, it ensures that new designs remain consistent with your current tech stack while proactively identifying technical risks, race conditions, and security gaps. The end result is a production-ready design document complete with Mermaid diagrams and a granular implementation roadmap.

Key Features

01Automated codebase surveying to align designs with existing patterns and tech stacks.

02Granular implementation guidance with task-level work breakdowns for developers.

03Automatic generation of Mermaid architecture and sequence diagrams.

04Intelligent PRD gap analysis to identify TBDs and technical assumptions.

050 GitHub stars

06Structured 6-round Q&A covering data models, APIs, infrastructure, and security.

Use Cases

01Converting a high-level PRD into a detailed technical specification for a new feature.

02Planning complex database migrations or API contract changes with backward compatibility.

03Standardizing documentation for new microservices or modules within an existing repository.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryanismert/claude-plugin-build design

For use in Claude.ai and ChatGPT

Download Skill