When should I use the docs-conceptual skill?

Use this skill whenever you need to explain a design decision, provide an architectural overview, or help a reader understand the mental model behind a complex feature.

Does this skill help with technical diagrams?

Yes, it is designed to include structured ASCII or Markdown-based diagrams to visually represent flows, service interactions, and system hierarchies.

What is conceptual documentation?

Conceptual documentation explains the high-level principles and architecture of a system, focusing on 'how' and 'why' things work rather than just listing API endpoints or step-by-step tasks.

How does this differ from the tutorial skill?

While a tutorial teaches by doing (hands-on), conceptual documentation teaches by explaining principles and building understanding of the underlying system.

Conceptual Documentation Architect

Name: Conceptual Documentation Architect
Author: darylldoyle

bydarylldoyle

0•

Learning & Documentation

Generates high-level conceptual documentation focused on system architecture, design decisions, and mental models.

The docs-conceptual skill is designed to bridge the gap between code and comprehension by creating documentation that explains the 'why' and 'how' of a system. It moves beyond simple API references to build mental models for users, utilizing a problem-first approach, analogies, and structured diagrams. This skill is essential for documenting complex architectures, justifying design trade-offs, and ensuring that technical teams share a consistent understanding of a project's core principles and workflows.

Key Features

01Analogy-driven writing to simplify complex concepts

02Problem-first explanation structure for better context

030 GitHub stars

04Automated ASCII diagram generation for visual architecture

05Strict single-concept focus to prevent information overload

06Comparative trade-off analysis for design decisions

Use Cases

01Drafting architectural overviews for new software projects

02Explaining complex data flows or state management logic

03Creating 'How it Works' guides for technical stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add darylldoyle/docs-skills docs-conceptual

For use in Claude.ai and ChatGPT

Key Features

01Analogy-driven writing to simplify complex concepts

02Problem-first explanation structure for better context

030 GitHub stars

04Automated ASCII diagram generation for visual architecture

05Strict single-concept focus to prevent information overload

06Comparative trade-off analysis for design decisions

Use Cases

01Drafting architectural overviews for new software projects

02Explaining complex data flows or state management logic

03Creating 'How it Works' guides for technical stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add darylldoyle/docs-skills docs-conceptual

For use in Claude.ai and ChatGPT