Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add zookanalytics/gc-toolkit --skill architect-designgit clone --depth 1 https://github.com/zookanalytics/gc-toolkitWrote 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/zookanalytics/gc-toolkit/architect-design)<a href="https://agentmods.dev/skills/zookanalytics/gc-toolkit/architect-design"><img src="https://agentmods.dev/badge/skills/zookanalytics/gc-toolkit/architect-design/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/zookanalytics/gc-toolkit/architect-design"><img src="https://agentmods.dev/badge/skills/zookanalytics/gc-toolkit/architect-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00000 | $0.01036 |
| Opus 5.5 | $0.00000 | $0.00414 |
| Sonnet 5.5 | $0.00000 | $0.00207 |
| Haiku 4.5 | $0.00000 | $0.00104 |
Grade A, and why
architect-design 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 29d 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 — 87 lines — stays where its author put it; the contents beside it link to each section on GitHub.
architect-design
A method-skill of the architect persona (see the
architectidentity skill). Self-contained: it carries its own method and declares the files it reads/writes. Engage it whenever the work is to design — as a mol step on its own, or when a session has worn the architect identity. Settling structure before the code is written.
Files I read and write
- Read: the PRD / change request / idea being designed; the existing
docs/architecture.md(the current shape, if any); the code regions whose boundaries the change touches. - Write (advisory):
docs/architecture.md— append/update the decisions and the shape. Advisory: I keep it current; nothing enforces it.
The stance
Elicitation is the value; drafting is the anti-pattern. A finished design produced from two quick questions is the failure mode, not the win. Gather context and ask the questions that change the answer before committing structure. Surface trade-offs, not verdicts.
Method
- Read the inputs to know the job. Which are you in?
- a spec/PRD to turn into structure;
- a raw idea to shape;
- an existing codebase to derive the shape from (ratify the conventions already there before inventing new ones);
- a change to an existing system (inherit its current invariants as constraints — treat already-settled decisions as read-only unless the change is explicitly to revisit them).
- Elicit. Ask the clarifying questions whose answers would change the structure — non-functional requirements (scale, latency, consistency, failure modes), the boundaries that already exist, what must stay reversible. Don't proceed past a genuinely open question; surface it.
- Pin only the invariants — the inclusion test. Fix a decision in the
architecture only when all three hold:
- two parts one level down, built independently, could choose incompatibly (paradigm, boundary & dependency rules, how state is mutated, who owns shared data, the contract between units), and
- the call is non-obvious, and
- it's a real trade-off (not a default everyone would reach anyway).
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.
- 29d ago First seen · 87 lines · 0 tokens per session scan A dfe41ee9fc3d
architect-design is a skill published in the GitHub repository zookanalytics/gc-toolkit (5 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,036 tokens. 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-09-19.
Other skills, from other repositories
agent-harness-fault-injection
Use when an agent workflow needs deterministic recovery evidence for sandbox, MCP/tool, worker, checkpoint, memory, or orchestration failures.
sector-rotation
An analysis framework for comparing industries in the Chinese A-share stock market, using business conditions, price momentum, valuation, and money flows. It produces rankings and higher- or lower-allocation suggestions.
foundry-config-setup
Resolve missing setup caused by a hardcoded Foundry project endpoint or model in a sample. Use when a sample fails because it uses a placeholder/hardcoded projectendpoint (for example "https://your-project.services.ai.azure.com") or a hardcoded model instead of reading them from the environment.
oma-hwp
Convert Hangul HWP, HWPX, or HWPML documents to Markdown with kordoc. Use for text, table, and image extraction from these formats.
browser_cdp
A health check for Python code that produces a score, letter grade, and measures of issues such as complexity, duplication, dead code, dependencies, and architecture.
config-validator
Validate AIWG configuration files and project setup for correctness and completeness.