Agent skill

Audit Architecture

by freekmurze in freekmurze/dotfiles

Run an application-wide, read-only architecture audit that finds materially useful simplifications in a codebase's data structures, state representation, control flow, algorithms, and ownership…

No licenceAuto-check passedDevelopment

Install Audit Architecture

skills CLI
$ npx skills add freekmurze/dotfiles --skill audit-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install freekmurze/dotfiles audit-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/freekmurze/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/config/claude/skills/audit-architecture .claude/skills/audit-architecture && rm -rf skills-src

Use ~/.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/

Facts

Skill name
audit-architecture
GitHub stars
1k
Token cost
~1.6k tokens
SKILL.md length
753 words
Files
2
Skills in repo
52
Repo updated
First seen
Licence
None found

At a glance

Run an application-wide, read-only architecture audit that finds materially useful simplifications in a codebase's data structures, state representation, control flow, algorithms, and ownership…

  • Works in 4 steps: Establish the coverage contract → Run bounded subsystem reviews → Validate and synthesize → …
  • Asked to audit architecture
  • SKILL.md covers 1. Establish the coverage…, 2. Run bounded subsystem reviews, 3. Validate and synthesize and 4. Audit the audit, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Audit Architecture is an agent skill from freekmurze/dotfiles. Run an application-wide, read-only architecture audit that finds materially useful simplifications in a codebase's data structures, state representation, control flow, algorithms, and ownership boundaries. Fans out bounded read-only agents per subsystem, verifies every finding against the repo, and ranks results P0 to P3. Use when asked to audit architecture, review how state or data is modelled, find structural simplifications, or invoke /audit-architecture. Not a style or line-level quality pass (use /simplify…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Software architecture.

When your agent uses it

  • Asked to audit architecture
  • Review how state
  • Data is modelled
  • Find structural simplifications

Example prompts

  • “/audit-architecture”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Establish the coverage contract
  2. Run bounded subsystem reviews
  3. Validate and synthesize
  4. Audit the audit

What it can do on your machine

Read from SKILL.md and the folder at commit 8874280. 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

Audit Architecture loads about 1.6k tokens when it runs. Until then it costs about 146 tokens; SKILL.md has 753 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~146
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 753 words (~1,606 tokens).

“Audit this entire codebase for materially useful simplifications in its data structures, state representation, control flow, algorithms, and ownership.”

— opening of SKILL.md by freekmurze
name
audit-architecture
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in config/claude/skills/audit-architecture of freekmurze/dotfiles.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 8874280

Compare with similar skills

Audit 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.

Audit Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Audit Architecture this skillfreekmurze/dotfiles1k—~1.6kAutomated safety check: PassNone
Archify Diagramstt-a1i/archify81k—~2.9kAutomated safety check: PassMIT
Electron Multi-Process ArchitectureiOfficeAI/AionUi33k1 repos~1.8kAutomated safety check: PassApache-2.0
Backend Code Reviewlanggenius/dify158k—~676Automated safety check: PassCustom licence
Dark Architecture Diagram BuilderCocoon-AI/architecture-diagram-generator7.4k1 repos~2.1kAutomated safety check: PassMIT
SVG Diagram GeneratorJimLiu/baoyu-skills27k1 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • 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.

    81k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • 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.

    33k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed
  • 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.

    158k GitHub stars~676 tokensUpdated today
    DevelopmentAuto-check passed
  • 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.

    7.4k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • SVG Diagram Generator

    JimLiu/baoyu-skills

    Creates standalone dark-themed SVG diagrams, including architecture, flowchart, sequence, structural, mind map, timeline and state machine types.

    27k GitHub starsUsed in 1 repo~3.1k tokens
    DevelopmentAuto-check passed
  • 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…

    260 GitHub starsUsed in 8 repos~1.2k tokens
    DevelopmentAuto-check: notes

More from freekmurze/dotfiles

All 52 skills in this repo
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Auto-check passed
  • Email Sequence

    freekmurze/dotfiles

    When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program.

    1k GitHub starsUsed in 19 repos~2k tokens
    Auto-check passed
  • Referral Program

    freekmurze/dotfiles

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    1k GitHub starsUsed in 17 repos~1.8k tokens
    Auto-check passed
  • Onboarding Cro

    freekmurze/dotfiles

    When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value.

    1k GitHub starsUsed in 16 repos~1.6k tokens
    Auto-check passed
  • Typefully

    freekmurze/dotfiles

    Create, schedule, and manage social media posts via Typefully.

    1k GitHub starsUsed in 1 repo~3.4k tokens
    Auto-check: notes
  • Paywall Upgrade Cro

    freekmurze/dotfiles

    When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates.

    1k GitHub starsUsed in 15 repos~1.4k tokens
    Auto-check passed

Categories

Questions about Audit Architecture

What does Audit Architecture do?

Run an application-wide, read-only architecture audit that finds materially useful simplifications in a codebase's data structures, state representation, control flow, algorithms, and ownership…. Audit Architecture is an agent skill from freekmurze/dotfiles. Run an application-wide, read-only architecture audit that finds materially useful simplifications in a codebase's data structures, state representation, control flow, algorithms, and ownership boundaries.

When should I use Audit Architecture?

Audit Architecture fits situations like: asked to audit architecture; review how state; data is modelled; find structural simplifications.

How do I install Audit Architecture in Claude Code?

Run `npx skills add freekmurze/dotfiles --skill audit-architecture -a claude-code`. Or copy the skill folder (config/claude/skills/audit-architecture in freekmurze/dotfiles) into .claude/skills/audit-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Audit Architecture in Codex?

Run `npx skills add freekmurze/dotfiles --skill audit-architecture -a codex`. Or copy the skill folder (config/claude/skills/audit-architecture in freekmurze/dotfiles) into .agents/skills/audit-architecture in your project. Codex loads it when a task matches its description.

Can I use Audit 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 freekmurze/dotfiles --skill audit-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/audit-architecture, .gemini/skills/audit-architecture, .github/skills/audit-architecture and .opencode/skills/audit-architecture in your project.

What does Audit Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Audit Architecture is instructions for the agent only.

Does Audit 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 Audit 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 Audit Architecture use?

No licence was found for Audit Architecture or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Audit Architecture use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Audit Architecture?

Skills that share tags, products or a category with Audit Architecture: Archify Diagrams (tt-a1i/archify, 81k 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 Audit Architecture?

freekmurze (a GitHub user) maintains it in freekmurze/dotfiles, which has 1,013 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 8, 2026.

Source: freekmurze/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.