Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/jrjsmrtn/project-orchestration-skillsnpx agentmods add skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-codeWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-code)<a href="https://agentmods.dev/skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-code"><img src="https://agentmods.dev/badge/skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-code/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-code"><img src="https://agentmods.dev/badge/skills/jrjsmrtn/project-orchestration-skills/setup-architecture-as-code.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
SkillSpector: 1 finding, up to low
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- low Tool Misuse · line 486 Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00043 | $0.04578 |
| Opus 5 | $0.00022 | $0.02289 |
| Sonnet 5 | $0.00009 | $0.00916 |
| Haiku 4.5 | $0.00004 | $0.00458 |
Grade A, and why
setup-architecture-as-code scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 613 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Setup Architecture-as-Code
Establish architecture-as-code practice using C4 modeling and Structurizr DSL.
When to Use
- After running
bootstrap-projectskill - When establishing architecture documentation for a project
- When migrating from diagram-based to code-based architecture documentation
- When you need version-controlled, validated architecture models
What is Architecture-as-Code?
Architecture-as-Code treats architecture documentation like source code:
| Traditional Diagrams | Architecture-as-Code |
|---|---|
| Draw in GUI tools | Define in text/DSL |
| Manual updates | Automated validation |
| Binary files (PNG, VSDX) | Text files (version control friendly) |
| Diagrams diverge from reality | Single source of truth |
| Hard to review changes | PR-reviewable changes |
| No validation | Syntax + semantic validation |
Implementation Stack:
- Modeling Approach: C4 Model (Context, Container, Component, Code)
- Definition Language: Structurizr DSL
- Validation & Inspection: structurizr/structurizr (consolidated image, replaces deprecated
structurizr/cliandstructurizr/lite) - Visualization: structurizr/structurizr
localsubcommand or Structurizr Cloud
Required Inputs
- Project/System name
- System description (1-2 sentences)
- Key users/personas (who interacts with the system)
- External systems (what the system integrates with)
- Main containers (applications, databases, services)
- Technology stack (languages, frameworks, databases)
C4 Model Overview
The C4 model provides four levels of abstraction (zoom levels):
| Level | Name | Purpose | Audience |
|---|---|---|---|
| 1 | System Context | System in its environment | Everyone |
| 2 | Container | Deployable units | Technical staff |
| 3 | Component | Internal structure | Developers |
| 4 | Code | Class/module level | Developers (often generated) |
Key Principle: Start with Level 1-2, add Level 3 only when needed. Level 4 is usually generated from code.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 10d ago First seen · 613 lines · 43 tokens per session scan A 4f64b1171e9b
setup-architecture-as-code is a skill published in the GitHub repository jrjsmrtn/project-orchestration-skills (15 stars, last pushed 6d ago), licensed MIT. It adds 43 tokens to every session and 4,578 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
taiyi-ui-design
A design-planning guide for describing how an application's user interface should look and behave. It produces a UI-DESIGN.md document covering layouts, components, interactions, accessibility, and error states.
taiyi-diagram-arch
A workflow for turning written system or product architecture into readable, version-controlled diagrams using Mermaid or exported SVG and PNG files. Architecture diagrams show components, boundaries, data flows, and deployment relationships.
taiyi-restyle
A planning guide for breaking a large user-interface redesign into smaller, independently reviewable tasks. A user interface is the part of an application that people see and use.
taiyi-diagram-pipeline
A pipeline that creates and updates architecture diagrams in three stages: a C4 model from the code, an engineering architecture diagram, and an exported PNG image. C4 is a way to describe software architecture at several levels of detail.
taiyi-diagram-render
A tool for rendering existing C4 or architecture Mermaid diagrams as SVG or PNG images. C4 is a way to show software systems at different levels, while Mermaid is a text format for diagrams.
preview
Divergent-discard instantiation. Fires when direction candidates cannot be recognized from descriptions. Type: (DirectionUnrecognizable, Hybrid, PREVIEW, DirectionProspect) → DirectionalContrast.