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.
Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why.
Install Solution Architecture
$ npx skills add cbrock84/headcount --skill solution-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cbrock84/headcount solution-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/cbrock84/headcount.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .claude/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .claude/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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/cbrock84/headcount/tree/main/plugins/technology/skills/solution-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 cbrock84/headcount --skill solution-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cbrock84/headcount solution-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cbrock84/headcount.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .agents/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .agents/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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 cbrock84/headcount --skill solution-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cbrock84/headcount solution-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cbrock84/headcount.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .cursor/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .cursor/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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/cbrock84/headcount.git --path plugins/technology/skills/solution-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 cbrock84/headcount --skill solution-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cbrock84/headcount solution-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cbrock84/headcount.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .gemini/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .gemini/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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 cbrock84/headcount solution-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 cbrock84/headcount --skill solution-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cbrock84/headcount.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .github/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .github/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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 cbrock84/headcount --skill solution-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 cbrock84/headcount solution-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cbrock84/headcount.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/technology/skills/solution-architecture .opencode/skills/solution-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 "solution-architecture" agent skill from https://github.com/cbrock84/headcount/tree/main/plugins/technology/skills/solution-architecture into .opencode/skills/solution-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "solution-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
solution-architecture- GitHub stars
- 2k
- Token cost
- ~804 tokens
- SKILL.md length
- 427 words
- Files
- 2 (incl. references)
- Skills in repo
- 175
- Repo updated
- First seen
- Licence
- MIT
At a glance
Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why.
- Tasks that involve Software architecture
- SKILL.md covers Start from what constrains,…, Boundaries are the whole game, Trade-offs, stated and Record decisions, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Solution Architecture is an agent skill from cbrock84/headcount. Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why. Use this to design a new system or major component, choose between architectural options, review an existing design, decide where a boundary belongs, or document an architectural decision so it survives the people who made it.
Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/sources.md`).
It sits in Development, covering Software architecture. The repository describes itself as: An agent organization structured as a company — 15+ departments, 125+ skills, each independently installable, citing the standards and regulators that settle the question. Runs… The licence is MIT.
When your agent uses it
- Tasks that involve Software architecture
Example prompts
- “Use the solution-architecture skill to design system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and…”
- “/solution-architecture”
What it can do on your machine
Read from SKILL.md and the folder at commit 98d1c17. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Solution Architecture loads about 804 tokens when it runs, and up to ~1k if it reads all its reference files. Until then it costs about 93 tokens; SKILL.md has 427 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 passed
The automated check found no risky patterns in SKILL.md.
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
The full file from cbrock84/headcount at commit 98d1c17, republished under its MIT licence (© cbrock84). 427 words, ~804 tokens.
Download SKILL.mdSave it as
.claude/skills/solution-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- solution-architecture
- description
- Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why. Use this to design a new system or major component, choose between architectural options, review an existing design, decide where a boundary belongs, or document an architectural decision so it survives the people who made it.
Solution architecture
Architecture is the set of decisions that are expensive to reverse. Everything cheap to change later is design, and does not need this level of ceremony.
Start from what constrains, not from what appeals
Architecture is driven by quality attributes, not by features. Establish the ones that actually bind before drawing anything: expected load and its shape, latency the user notices, availability the business will fund, data residency and retention obligations, the rate of change the team needs to sustain, and the size and skills of the team who will operate it.
Vague attributes produce vague architecture. "Scalable" is not a requirement; "20,000 concurrent sessions with p99 under 300ms" is a constraint that eliminates options.
Boundaries are the whole game
Draw boundaries where change is independent and where data has a single owner. A boundary in the right place absorbs change; a boundary in the wrong place turns every feature into a negotiation across three teams.
The reliable test: if a routine change requires coordinated deployment across two components, the boundary is wrong regardless of how clean the diagram looks.
Prefer coarse boundaries until you have evidence for finer ones. Distributed systems convert simple in-process failures into network, partial-failure and consistency problems — a cost worth paying for independent scaling or independent deployment, and not worth paying for tidiness.
Trade-offs, stated
Every architecture sacrifices something. The failure is not choosing badly; it is choosing without naming what was given up, so nobody later understands why the constraint exists.
Present options with their costs: what each makes easy, what each makes hard, what it costs to operate, and what it would take to reverse. Two credible options and an honest comparison beat one recommendation.
Show full SKILL.md (143 more words)Show less
Record decisions
Write down the decision, the context at the time, the options considered, and the consequences accepted. Architecture rots because the reasoning evaporates while the structure remains, and the next team reads a constraint as an accident.
Keep records short and immutable — supersede rather than edit, so the history of thinking survives.
Sources
references/sources.md in this skill lists the outside authorities that settle the questions
here — what each one is authoritative for, and what you may do with it. Check them before
answering on anything they cover, and cite what you used. Most are free to read and not free
to reproduce; the use note on each is binding.
Never
- Design against quality attributes nobody has quantified.
- Split a system into services to make the diagram tidy.
- Present a single option as though no trade-off was made.
- Leave an expensive-to-reverse decision undocumented.
© cbrock84, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in plugins/technology/skills/solution-architecture of cbrock84/headcount.
- SKILL.md
- references/sources.md
Open the folder on GitHubat commit 98d1c17
Compare with similar skills
Solution 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 |
|---|---|---|---|---|---|---|
| Solution Architecture this skillcbrock84/headcount | 2k | — | ~804 | Automated safety check: Pass | MIT | |
| Archify Diagramstt-a1i/archify | 79k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Electron Multi-Process ArchitectureiOfficeAI/AionUi | 33k | 1 repos | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Backend Code Reviewlanggenius/dify | 158k | — | ~676 | Automated safety check: Pass | Custom licence | |
| Dark Architecture Diagram BuilderCocoon-AI/architecture-diagram-generator | 7.4k | 1 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Code Graph Mermaid Diagramstrailofbits/skills | 7.4k | 1 repos | ~1.7k | Automated safety check: Pass | CC-BY-SA-4.0 |
Similar skills
Electron Multi-Process Architecture
iOfficeAI/AionUi
Tells the agent where new code belongs in an Electron multi-process project and which APIs each process may use, with rules for new bridges, services, agents and workers.
Backend Code Review
langgenius/dify
Reviews backend code under api/ for concrete, reproducible defects, routes to rule packs for architecture, schema, repositories and SQLAlchemy, and ranks findings from P0 to P3.
Dark Architecture Diagram Builder
Cocoon-AI/architecture-diagram-generator
Creates dark-themed system, cloud, security and network architecture diagrams as self-contained HTML files with inline SVG and CSS.
- Official
Code Graph Mermaid Diagrams
trailofbits/skills
Generates Mermaid diagrams from Trailmark code graphs, including call graphs, class hierarchies, module dependency maps, complexity heatmaps and attack surface data flows.
Senior Architect Toolkit
maslennikov-ig/claude-code-orchestrator-kit
Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin…
More from cbrock84/headcount
All 175 skills in this repoAgent Hierarchy
cbrock84/headcount
Designs orchestrator-and-subagent hierarchies for a repository — splitting agents by exclusive write surface, pairing every producer with an independent auditor, and enforcing the split with a…
Access And Identity
cbrock84/headcount
Designs and audits who can reach what — authentication, authorization models, privileged access, service credentials, and joiner-mover-leaver process.
Account Based Marketing
cbrock84/headcount
Concentrates marketing and sales effort on a named set of accounts rather than on volume — qualifying whether the model fits your economics at all, building the account list and the buying group…
Activation
cbrock84/headcount
Gets new users from signup to first real value — signup flow, onboarding, time-to-value, and the early experience that determines whether someone becomes a user or a lapsed account.
AI Research Analyst
cbrock84/headcount
Produces executive-level research — market sizing, competitor mapping, trend analysis, and strategic intelligence — grounded in cited sources with the confidence in each claim made explicit.
AI Search Optimization
cbrock84/headcount
Optimizes for AI assistants and AI-generated answers — being retrievable, being cited, and being represented accurately when a model answers on your behalf.
Related
Categories
Questions about Solution Architecture
What does Solution Architecture do?
Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why. Solution Architecture is an agent skill from cbrock84/headcount. Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why.
When should I use Solution Architecture?
Solution Architecture fits situations like: tasks that involve Software architecture.
How do I install Solution Architecture in Claude Code?
Run `npx skills add cbrock84/headcount --skill solution-architecture -a claude-code`. Or copy the skill folder (plugins/technology/skills/solution-architecture in cbrock84/headcount) into .claude/skills/solution-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Solution Architecture in Codex?
Run `npx skills add cbrock84/headcount --skill solution-architecture -a codex`. Or copy the skill folder (plugins/technology/skills/solution-architecture in cbrock84/headcount) into .agents/skills/solution-architecture in your project. Codex loads it when a task matches its description.
Can I use Solution 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 cbrock84/headcount --skill solution-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/solution-architecture, .gemini/skills/solution-architecture, .github/skills/solution-architecture and .opencode/skills/solution-architecture in your project.
What does Solution Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Solution Architecture is instructions for the agent only.
Does Solution Architecture access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Solution Architecture safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Solution Architecture use?
Solution Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Solution Architecture use?
About 804 tokens (SKILL.md is roughly 3.2k 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 212 tokens, read only when the agent opens those files.
What are the alternatives to Solution Architecture?
Skills that share tags, products or a category with Solution Architecture: Archify Diagrams (tt-a1i/archify, 79k stars), Electron Multi-Process Architecture (iOfficeAI/AionUi, 33k stars), Backend Code Review (langgenius/dify, 158k stars) and Dark Architecture Diagram Builder (Cocoon-AI/architecture-diagram-generator, 7.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Solution Architecture?
cbrock84 (a GitHub user) maintains it in cbrock84/headcount, which has 2,007 GitHub stars. The repository holds 175 skills in this directory. The repository was last updated on September 17, 2026.
Source: cbrock84/headcount on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.