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 alonbaron/claude-skills --skill architectgit clone --depth 1 https://github.com/alonbaron/claude-skillsWrote 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/alonbaron/claude-skills/architect)<a href="https://agentmods.dev/skills/alonbaron/claude-skills/architect"><img src="https://agentmods.dev/badge/skills/alonbaron/claude-skills/architect/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/alonbaron/claude-skills/architect"><img src="https://agentmods.dev/badge/skills/alonbaron/claude-skills/architect.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.00115 | $0.02155 |
| Opus 5 | $0.00057 | $0.01077 |
| Sonnet 5 | $0.00023 | $0.00431 |
| Haiku 4.5 | $0.00012 | $0.00215 |
Grade A, and why
architect 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 — 164 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Architect
Design and document the system before building it — in the house doc format, kept in sync at all times. Output is documents, not code.
Principles, enforced in the docs: model first (data + invariants before framework) · enforce every invariant at the core, ideally at two boundaries (app-layer validation and a DB constraint) — never "the frontend handles it" · design failure paths as deliberately as happy paths · small, reversible, independently shippable steps · one source of truth — everything else derives from it and links back.
Proactive use
If a new app, feature, or workstream is starting and no current design docs exist, invoke this without being asked: announce in one line — "Running architect: " — and proceed. Never ask permission to run the skill; the 1–3 blocking questions below are still allowed.
The four artifacts (+ the modular set)
Authority flows top-down. A fact lives in exactly one place and is linked from everywhere else.
SOURCE_OF_TRUTH.md(apex) — the canonical, slow-changing truth: scope & non-goals · the domain model · the invariants and where each is enforced · the load-bearing decisions as mini-ADRs (decision · why · alternative rejected). If anything conflicts with this file, this file wins. Keep it tight — it is the contract, not the manual.ARCHITECTURE_ROADMAP.md— architecture + phased plan derived from the SoT. Header block (Version · Status · Owner), then §-numbered:0Executive context ·1Tech stack (Layer · Tech · Role table) ·2Data schema (low-level: columns, types, constraints, indexes, JSONB shapes, decision call-outs) ·3Backend (structure · services · API-contract table) ·4Frontend ·5Execution phases ·6Non-functional requirements.docs/architecture/00-index.md+01-…NN(larger projects only) — agent-friendly modular extracts of the roadmap sections. The index carries a File Map table (# · file · covers · roadmap §), a Dependency Graph (ASCII), and a Quick Reference ("I need to work on X → read these files").TODO_WORKFLOW.md— the task tracker. Status legend ([ ]·[IN PROGRESS]·[FINISHED - PENDING MERGE]·[MERGED/DONE]·[BLOCKED]); tasks grouped by phase; each row:# · Task · Architecture Ref (linked to the §/file) · Status · Branch.CLAUDE.md(project root) — the rules file Claude Code auto-loads: operating rules + the sync protocol (template below). One markdown file — no.clauderules, no.cursorrules, no import shim.
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 · 164 lines · 115 tokens per session scan A 0194626f63d8
architect is a skill published in the GitHub repository alonbaron/claude-skills (13 stars, last pushed 1mo ago), licensed MIT. It adds 115 tokens to every session and 2,155 once invoked, about $0.0006 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
meta-tags-optimizer
Optimize title tags, meta descriptions, Open Graph, and Twitter cards for maximum click-through rate. Generates multiple A/B test variations with character counting and SERP preview. Use when asked to "optimize title tag", "write meta description", "improve CTR", "Open Graph tags", "fix my meta tags", "social media…
google-ads-audit
Google Ads account audit and business context setup. Use for account-health audits and business-context setup. Trigger on "audit my ads", "ads audit", "set up my ads", "onboard", "account overview", "how's my account", "ads health check", "what should I fix in my ads", or when the user is new to NotFair and hasn't run…
sxo
Search Experience Optimization (SXO) — the bridge between SEO and UX/CRO. Audits the full journey from the SERP click to the on-page goal: SERP click-through factors (title/meta/rich results that win the click), then post-click experience signals that keep users and drive conversions — above-the-fold relevance and…
critical-code-reviewer
Rigorously review code or pull requests for correctness, security, accessibility, maintainability, tests, and edge cases. Use when users request a critical code review, want a guided walkthrough of findings, need implementer-facing feedback, or want to prepare, create, or submit a GitHub pull request review.
shiny-bslib
Build modern Shiny dashboards and applications using bslib (Bootstrap 5). Use when creating new Shiny apps, modernizing legacy apps (fluidPage, fluidRow/column, tabsetPanel, wellPanel, shinythemes), or working with bslib page layouts, grid systems, cards, value boxes, navigation, sidebars, filling layouts, theming…
tidewave-integration
Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs. Use when evaluating code in a running Phoenix app.