Agent skill

Architectural Analysis

by pedronauck in pedronauck/skills

Audit architecture, dead code, duplication, type confusion, and code smells across a codebase.

No licenceAuto-check passedSecurity

Install Architectural Analysis

skills CLI
$ npx skills add pedronauck/skills --skill architectural-analysis -a claude-code

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

GitHub CLI
$ gh skill install pedronauck/skills architectural-analysis --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/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mine/architectural-analysis .claude/skills/architectural-analysis && 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
architectural-analysis
GitHub stars
634
Used in
1 other repo
Token cost
~524 tokens
SKILL.md length
233 words
Files
4 (incl. references, assets)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Audit architecture, dead code, duplication, type confusion, and code smells across a codebase.

  • Works in 6 steps: Resolve scope from the request/context.… → Prioritize signals: dead exports,… → Trace usage before declaring code dead,… → …
  • Tasks that involve Refactoring
  • Calls rg
  • Tasks that involve Security review

What it does

Architectural Analysis is an agent skill from pedronauck/skills. Audit architecture, dead code, duplication, type confusion, and code smells across a codebase. Excludes formatting, performance profiling, security audits, and feature-level reviews.

Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `assets/report-template.md`, `assets/summary-template.md` and `references/detection-catalog.md`).

It sits in Security, covering Refactoring and Security review. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Tasks that involve Refactoring
  • Tasks that involve Security review

Example prompts

  • “/architectural-analysis”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Resolve scope from the request/context. Map entry points and relevant dependencies with rg --files, scoped rg searches, and available…
  2. Prioritize signals: dead exports, duplicated responsibilities, cycles, confused ownership/types, and expensive change patterns. Read the…
  3. Trace usage before declaring code dead, including dynamic loading, reflection, framework hooks, tests, and published APIs. An unreferenced…
  4. Confirm each material finding in source. Explain the behavior or maintenance cost, cite paths/lines, state uncertainty, and propose the…
  5. Match report size to the request. For a broad audit, use assets/report-template.md as an adaptable outline and save…
  6. Summarize the important findings and evidence. Existing source and summary templates are optional presentation aids, not two required…

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • rg

    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

Architectural Analysis loads about 524 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 233 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~524
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.4k

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 233 words (~524 tokens).

“Audit the requested scope and report concrete design problems. An audit alone is read-only; existing explicit authorization to apply findings can include remediation. Use the project's boundaries and public compatibility policy when judging a design.”

— opening of SKILL.md by pedronauck
name
architectural-analysis
disable-model-invocation
true
metadata.author
Pedro Nauck
metadata.github
https://github.com/pedronauck
metadata.repository
https://github.com/pedronauck/skills

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references, assets) in skills/mine/architectural-analysis of pedronauck/skills.

  • SKILL.md
  • assets/report-template.md
  • assets/summary-template.md
  • references/detection-catalog.md

Open the folder on GitHubat commit 0422940

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in pedronauck/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Architectural Analysis 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.

Architectural Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architectural Analysis this skillpedronauck/skills6341 repos~524Automated safety check: PassNone
Code Review And Security Audithiroshiyui/GuilelessBopomofo135—~1.6kAutomated safety check: PassGPL-3.0
Tool Defs Analysiscyanheads/pubmed-mcp-server156—~4.8kAutomated safety check: PassApache-2.0
AuditMadAppGang/claude-code285—~3.3kAutomated safety check: PassMIT
Native Dependency Updatemono/SkiaSharp5.6k—~4.1kAutomated safety check: PassMIT
Skillward AuditFangcun-AI/SkillWard143—~2.9kAutomated safety check: PassCustom licence

Similar skills

  • Code Review And Security Audit

    hiroshiyui/GuilelessBopomofo

    Review code for quality, correctness, and security vulnerabilities.

    135 GitHub stars~1.6k tokensUpdated 12 days ago
    DevelopmentAuto-check passed
  • Tool Defs Analysis

    cyanheads/pubmed-mcp-server

    Read-only audit of MCP definition language across an existing surface — tools, resources, prompts, server instructions.

    156 GitHub stars~4.8k tokensUpdated 5 days ago
    SecurityAuto-check passed
  • Audit

    MadAppGang/claude-code

    On-demand security and code quality audit. An agent skill from MadAppGang/claude-code.

    285 GitHub stars~3.3k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Update native dependencies (libpng, libexpat, zlib, libwebp, harfbuzz, freetype, libjpeg-turbo, etc.) in SkiaSharp's Skia fork.

    5.6k GitHub stars~4.1k tokensUpdated today
    SecurityAuto-check passed
  • Skillward Audit

    Fangcun-AI/SkillWard

    Security-audit a third-party skill bundle (folder with SKILL.md, or .zip / .tar.gz archive) before installing it, using the SkillWard cloud scanner.

    143 GitHub stars~2.9k tokensUpdated 2 mo ago
    SecurityAuto-check passed
  • Security Audit

    TheDecipherist/claude-code-mastery

    Checks a codebase for hardcoded secrets, vulnerable dependencies, weak input handling, weak authentication and unsafe transport settings before deployment or merge.

    550 GitHub stars~1.3k tokensUpdated 5 mo ago
    SecurityAuto-check: notes

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 25 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 25 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 25 days ago
    Auto-check passed

Questions about Architectural Analysis

What does Architectural Analysis do?

Audit architecture, dead code, duplication, type confusion, and code smells across a codebase. Architectural Analysis is an agent skill from pedronauck/skills. Audit architecture, dead code, duplication, type confusion, and code smells across a codebase.

When should I use Architectural Analysis?

Architectural Analysis fits situations like: tasks that involve Refactoring; tasks that involve Security review.

How do I install Architectural Analysis in Claude Code?

Run `npx skills add pedronauck/skills --skill architectural-analysis -a claude-code`. Or copy the skill folder (skills/mine/architectural-analysis in pedronauck/skills) into .claude/skills/architectural-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Architectural Analysis in Codex?

Run `npx skills add pedronauck/skills --skill architectural-analysis -a codex`. Or copy the skill folder (skills/mine/architectural-analysis in pedronauck/skills) into .agents/skills/architectural-analysis in your project. Codex loads it when a task matches its description.

Can I use Architectural Analysis 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 pedronauck/skills --skill architectural-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architectural-analysis, .gemini/skills/architectural-analysis, .github/skills/architectural-analysis and .opencode/skills/architectural-analysis in your project.

What does Architectural Analysis need to run?

Going by SKILL.md and its folder, Architectural Analysis needs the command-line tools its instructions call (rg).

Does Architectural Analysis 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 Architectural Analysis 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 Architectural Analysis use?

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

How many tokens does Architectural Analysis use?

About 524 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 919 tokens, read only when the agent opens those files.

What are the alternatives to Architectural Analysis?

Skills that share tags, products or a category with Architectural Analysis: Code Review And Security Audit (hiroshiyui/GuilelessBopomofo, 135 stars), Tool Defs Analysis (cyanheads/pubmed-mcp-server, 156 stars), Audit (MadAppGang/claude-code, 285 stars) and Native Dependency Update (mono/SkiaSharp, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architectural Analysis?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

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