describe-designResearch a codebase and create architectural documentation describing how features or systems work. Use when the user asks to: (1) Document how a feature works, (2) Create an architecture overview, (3) Explain code structure for onboarding or knowledge transfer, (4) Research and describe a system's design. Produces markdown documents with Mermaid diagrams and stable code references suitable for humans and AI agents.
Install via ClawdBot CLI:
clawdbot install ziad-hsn/describe-designGrade Fair — based on market validation, documentation quality, package completeness, maintenance status, and authenticity signals.
Generated Mar 1, 2026
A financial services company is migrating a monolithic banking application to microservices. The Describe Design skill can analyze the existing codebase to document the current architecture, identify dependencies, and create a reference for developers to understand how legacy features work before refactoring. This ensures a smooth transition by providing clear documentation of interactions between old and new components.
A tech startup has rapid growth and needs to onboard multiple developers quickly. Using Describe Design, they can generate architectural overviews of key features like user authentication or payment processing, explaining code structure with Mermaid diagrams. This reduces ramp-up time and ensures consistent understanding across the team for efficient collaboration.
A healthcare software provider must document system designs for regulatory audits (e.g., HIPAA). Describe Design can research the codebase to create detailed architecture documents that trace data flows through components handling sensitive patient information. This helps demonstrate security measures and compliance with industry standards.
An open-source community maintains a large codebase with many contributors. Describe Design can be used to periodically update architectural documentation for new features or refactored modules, providing stable code references and diagrams. This keeps the project accessible to external developers and AI agents, fostering collaboration and knowledge transfer.
After a corporate acquisition, a company needs to integrate two disparate software systems. Describe Design can analyze both codebases to create comparative architecture documents, highlighting how features like APIs or databases interact. This aids in planning integration strategies and avoiding conflicts during the merger process.
Offer Describe Design as a cloud-based service where companies upload codebases to automatically generate architectural documentation. Charge subscription fees based on usage volume or number of projects. This model appeals to businesses needing regular updates without in-house expertise, providing recurring revenue through scalable automation.
Provide consulting services to help organizations implement Describe Design for specific projects, such as legacy system audits or compliance documentation. Offer training workshops on using the skill effectively. Revenue comes from one-time project fees and ongoing support contracts, leveraging expertise in code analysis and documentation best practices.
License Describe Design to large enterprises for internal use across multiple teams, such as in finance or healthcare sectors. Include customization options for industry-specific needs and integration with existing tools. Revenue is generated through annual licensing fees and premium support packages, ensuring long-term partnerships with high-value clients.
💬 Integration Tip
Integrate Describe Design into CI/CD pipelines to automatically update documentation with code changes, ensuring it stays current and reduces manual effort.
Scored Apr 19, 2026
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Systematic code review patterns covering security, performance, maintainability, correctness, and testing — with severity levels, structured feedback guidance, review process, and anti-patterns to avoid. Use when reviewing PRs, establishing review standards, or improving review quality.
Coding style memory that adapts to your preferences, conventions, and patterns for consistent coding.
Provides a 7-step debugging protocol plus language-specific commands to systematically identify, verify, and fix software bugs across multiple environments.
Control and operate Opencode via slash commands. Use this skill to manage sessions, select models, switch agents (plan/build), and coordinate coding through Opencode.
Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions