Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
Generate/update architecture docs — ARCHITECTURE.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD.
Install Docs Architecture
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jh941213/my-cc-harness docs-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_en/docs-architecture .claude/skills/docs-architecture && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .claude/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jh941213/my-cc-harness docs-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills_en/docs-architecture .agents/skills/docs-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .agents/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jh941213/my-cc-harness docs-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills_en/docs-architecture .cursor/skills/docs-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .cursor/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jh941213/my-cc-harness.git --path skills_en/docs-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jh941213/my-cc-harness docs-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills_en/docs-architecture .gemini/skills/docs-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .gemini/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jh941213/my-cc-harness docs-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills_en/docs-architecture .github/skills/docs-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .github/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jh941213/my-cc-harness --skill docs-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jh941213/my-cc-harness docs-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jh941213/my-cc-harness.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills_en/docs-architecture .opencode/skills/docs-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "docs-architecture" agent skill from https://github.com/jh941213/my-cc-harness/tree/main/skills_en/docs-architecture into .opencode/skills/docs-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
docs-architecture- GitHub stars
- 126
- Token cost
- ~923 tokens
- SKILL.md length
- 313 words
- Files
- 3 (incl. references)
- Skills in repo
- 62
- Repo updated
- First seen
- Licence
- None found
At a glance
Generate/update architecture docs — ARCHITECTURE.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD.
- Works in 5 steps: A map, not an atlas — coarse modules and… → First a bird's-eye view of the problem… → Name important symbols but don't… → …
- Writing/updating architecture docs
- SKILL.md covers Input, Choosing the artifact…, ARCHITECTURE.md rules (codemap) and Diagrams, plus 3 more sections
- Calls git
What it does
Docs Architecture is an agent skill from jh941213/my-cc-harness. Generate/update architecture docs — ARCHITECTURE.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD. Use when writing/updating architecture docs or diagrams, recording ADRs, documenting ERD/data models, reflecting structural refactors in docs. Not for API specs (docs-interfaces), user/ops manuals (docs-manuals), or code implementation
Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/mermaid-conventions.md` and `templates/adr.md`).
It sits in Development, covering Diagrams and Architecture decision records. It works with Mermaid.
When your agent uses it
- Writing/updating architecture docs
- Documenting ERD/data models
- Reflecting structural refactors in docs
Example prompts
- “/docs-architecture”
Requirements
- Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- A map, not an atlas — coarse modules and relations only. No per-file listing
- First a bird's-eye view of the problem the system solves, then the codemap
- Name important symbols but don't hyperlink them (links rot — readers use symbol search)
- State architectural invariants (e.g., "the domain layer never imports infra")
- Don't write what reading the code reveals — write decisions/reasons the structure can't show
What it can do on your machine
Read from SKILL.md and the folder at commit e9210e2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteEditGlobGrepBash
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Docs Architecture loads about 923 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 313 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 313 words (~923 tokens).
“Documents the structural facts of a project. Output goes under docs/; diagrams are mermaid (native repo rendering).”
- name
- docs-architecture
- allowed-tools
- Read, Write, Edit, Glob, Grep, Bash
- user-invocable
- true
- disable-model-invocation
- false
Files
SKILL.md and 2 other files (references) in skills_en/docs-architecture of jh941213/my-cc-harness.
- SKILL.md
- references/mermaid-conventions.md
- templates/adr.md
Open the folder on GitHubat commit e9210e2
Compare with similar skills
Docs Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Docs Architecture this skilljh941213/my-cc-harness | 126 | — | ~923 | Automated safety check: Notes | None | |
| Design Doc MermaidSpillwaveSolutions/design-doc-mermaid | 175 | 1 repos | ~5.6k | Automated safety check: Pass | None | |
| Architecture Decisions and ADRsfirst-fluke/oh-my-agent | 1.3k | — | ~2.6k | Automated safety check: Pass | MIT | |
| Senior Architectalirezarezvani/claude-skills | 28k | 4 repos | ~2.7k | Automated safety check: Pass | MIT | |
| System Architecture DesignerJeffallan/claude-skills | 12k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Generating Documentationancoleman/ai-design-components | 526 | — | ~3k | Automated safety check: Pass | MIT |
Similar skills
Architecture Decisions and ADRs
first-fluke/oh-my-agent
Evaluates system boundaries and tradeoffs and writes architecture recommendations, option comparisons or ADRs, with a Mermaid diagram when structure changes.
Senior Architect
alirezarezvani/claude-skills
This skill should be used when the user asks to "design system architecture", "evaluate microservices vs monolith", "create architecture diagrams", "analyze dependencies", "choose a database", "plan…
System Architecture Designer
Jeffallan/claude-skills
Guides system architecture design end to end: gathering requirements, matching them to a pattern, documenting trade-offs with ADRs, and reviewing.
Generating Documentation
ancoleman/ai-design-components
Generate comprehensive technical documentation including API docs (OpenAPI/Swagger), code documentation (TypeDoc/Sphinx), documentation sites (Docusaurus/MkDocs), Architecture Decision Records…
Archify Diagrams
tt-a1i/archify
Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.
More from jh941213/my-cc-harness
All 62 skills in this repoAPI Design Principles
jh941213/my-cc-harness
REST 및 GraphQL API 설계 원칙 가이드. An agent skill from jh941213/my-cc-harness.
Tailwind Design System
jh941213/my-cc-harness
Build scalable design systems with Tailwind CSS, design tokens, component libraries, and responsive patterns.
Auto Memory
jh941213/my-cc-harness
A skill your agent uses when starting substantial work in a repo (implementation, fixes, deploys, debugging), when first exploring a new repo, or when finishing work that produced reusable knowledge.
Async Python Patterns
jh941213/my-cc-harness
Python asyncio 및 async/await 패턴 가이드. An agent skill from jh941213/my-cc-harness.
Python Testing Patterns
jh941213/my-cc-harness
Implement comprehensive testing strategies with pytest, fixtures, mocking, and test-driven development.
Autodev
jh941213/my-cc-harness
Ralph Loop based autonomous development loop. An agent skill from jh941213/my-cc-harness.
Related
Works with
Categories
Questions about Docs Architecture
What does Docs Architecture do?
Generate/update architecture docs — ARCHITECTURE.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD. Docs Architecture is an agent skill from jh941213/my-cc-harness.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD.
When should I use Docs Architecture?
Docs Architecture fits situations like: writing/updating architecture docs; documenting ERD/data models; reflecting structural refactors in docs.
How do I install Docs Architecture in Claude Code?
Run `npx skills add jh941213/my-cc-harness --skill docs-architecture -a claude-code`. Or copy the skill folder (skills_en/docs-architecture in jh941213/my-cc-harness) into .claude/skills/docs-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Docs Architecture in Codex?
Run `npx skills add jh941213/my-cc-harness --skill docs-architecture -a codex`. Or copy the skill folder (skills_en/docs-architecture in jh941213/my-cc-harness) into .agents/skills/docs-architecture in your project. Codex loads it when a task matches its description.
Can I use Docs Architecture in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jh941213/my-cc-harness --skill docs-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-architecture, .gemini/skills/docs-architecture, .github/skills/docs-architecture and .opencode/skills/docs-architecture in your project.
What does Docs Architecture need to run?
Going by SKILL.md and its folder, Docs Architecture needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash.
Does Docs Architecture access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Docs Architecture safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Docs Architecture use?
No licence was found for Docs Architecture or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Docs Architecture use?
About 923 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 629 tokens, read only when the agent opens those files.
What are the alternatives to Docs Architecture?
Skills that share tags, products or a category with Docs Architecture: Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 175 stars), Architecture Decisions and ADRs (first-fluke/oh-my-agent, 1.3k stars), Senior Architect (alirezarezvani/claude-skills, 28k stars) and System Architecture Designer (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Docs Architecture?
jh941213 (a GitHub user) maintains it in jh941213/my-cc-harness, which has 126 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on August 3, 2026.
Source: jh941213/my-cc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.