A Skill that scans Claude Code's global and project folders and writes an ARCHITECTURE.md map of installed Skills, agents, and commands.

Use it when you want to map your plugins, inspect available capabilities, find duplicates, or document the structure of a Claude Code environment.

It shows what is installed and highlights overlapping responsibilities or semantic collisions between add-ons.

map — Skill for Claude Code by ordinary9843/claude-architecture-mapper

Install

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.

Any agent

npx skills add ordinary9843/claude-architecture-mapper --skill map

Clone the repo

git clone --depth 1 https://github.com/ordinary9843/claude-architecture-mapper

Made for: Claude Code.

Or install architecture-mapper, the plugin that ships this one along with the rest of its 1 skill.

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

README.md

[![agentmods](https://agentmods.dev/badge/skills/ordinary9843/claude-architecture-mapper/map/github.svg)](https://agentmods.dev/skills/ordinary9843/claude-architecture-mapper/map)

Your own site

<a href="https://agentmods.dev/skills/ordinary9843/claude-architecture-mapper/map"><img src="https://agentmods.dev/badge/skills/ordinary9843/claude-architecture-mapper/map/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/ordinary9843/claude-architecture-mapper/map"><img src="https://agentmods.dev/badge/skills/ordinary9843/claude-architecture-mapper/map.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,765 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

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.00084	$0.02765
Opus 5.5	$0.00034	$0.01106
Sonnet 5.5	$0.00017	$0.00553
Haiku 4.5	$0.00008	$0.00277

Measured 2mo ago against content hash 203e94a929b3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

map 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 2mo 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.

skills/map/SKILL.md · 272 lines

How it starts

The opening of the file, as written. The whole thing — 272 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Claude Architecture Mapper

Allowed tools: Read, Glob, Grep (scanning). Write (ARCHITECTURE.md only). No Bash, Edit, or other tools.

Step 1: Load Formatting Rules

The base directory for this skill is printed in the <command-message> header as: Base directory for this skill: <absolute-path>

Use that absolute path to construct all reference file paths. Never use relative paths or ~ with the Read tool.

Read these two files before doing anything else:

<base_dir>/references/mermaid-rules.md — Mermaid syntax constraints (MUST follow)
<base_dir>/references/doctor-rules.md — Diagnostic thresholds for bloat and collision

If either file cannot be read or is empty, report: Error: required reference file [filename] not found or is empty. Reinstall the claude-architecture-mapper plugin. and stop.

Step 2: Scan Both Scopes

Scan both scopes. Deduplicate by absolute path.

2a. Global Scope — Pre-flight: Resolve Home Directory

IMPORTANT: The Glob tool does not expand ~. You must use the absolute home path.

Derive the home directory from the <base_dir> value in the <command-message> header:

Extract the segment up to and including the username (e.g., /Users/jerry or /home/jerry)
Construct <home>/.claude/ as the global root

If <home>/.claude/ cannot be derived, note "Global scope unavailable" in the Ecosystem Health table and skip to Step 2b.

Use Glob with absolute paths to search these locations (substitute <home> with the resolved value):

<home>/.claude/agents/*.md
<home>/.claude/commands/*.md
<home>/.claude/skills/**/SKILL.md
<home>/.claude/plugins/cache/**/skills/**/SKILL.md
<home>/.claude/plugins/cache/**/agents/*.md
<home>/.claude/plugins/cache/**/.claude/commands/*.md
<home>/.claude/plugins/cache/**/.claude/agents/*.md

Scan plugins/cache/ only — this contains active installed plugins. plugins/marketplaces/ is the download catalogue; skip it entirely.

2b. Project Scope — Current Working Directory

Read the full file on GitHub · 272 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

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.

2mo ago First seen · 272 lines · 84 tokens per session scan A 203e94a929b3

Subscribe to this mod's changes

map is a skill published in the GitHub repository ordinary9843/claude-architecture-mapper (1 stars, last pushed 7mo ago), licensed MIT. It adds 84 tokens to every session and 2,765 once invoked, about $0.0003 per session on Opus 5.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-31.

Building agents Claude Code architecture-diagram claude-code-plugin dependency-graph developer-tools mermaid

map next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
mapordinary9843/claude-architecture-mapper	Skill	1	7mo ago	MIT	A	84	Claude Code
harness-mapdreamiurg/harness-map	Skill	4	5d ago	MIT	B	110	Claude Code
mk:visual-planngocsangyem/MeowKit	Skill	15	7d ago	MIT	A	188	Claude Code
reviewthisAAY/archeyes	Skill	8	3mo ago	MIT	A	94	Claude Code
arch-diagramJansenAnalytics/claudex	Skill	5	4mo ago	MIT	A	21	Claude Code, Codex
reviewSethGammon/Citadel	Skill	927	2d ago	MIT	A	17	Claude Code
wenlan-handoffwenlan-app/wenlan	Skill	94	today	Apache-2.0	A	43	Claude Code, Codex