From repo-analyser
Analyse code repositories and generate comprehensive architecture documentation. Use when the user asks to: analyse a codebase, understand project structure, document architecture, generate a codebase overview, review repo organisation, or map out how a project works.
How this skill is triggered — by the user, by Claude, or both
Slash command
/repo-analyser:repo-analyserThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate comprehensive architecture analysis for TypeScript and Python codebases.
Generate comprehensive architecture analysis for TypeScript and Python codebases.
Identify project type and structure:
# Check for key config files
ls -la *.json *.toml *.yaml *.yml 2>/dev/null
ls -la src/ app/ lib/ packages/ 2>/dev/null
Key indicators:
package.json → Node.js/TypeScriptpyproject.toml / requirements.txt → PythonUse Glob to understand directory layout:
**/*.ts or **/*.py for source files**/index.ts or **/__init__.py for module boundaries**/*.test.* or **/test_*.py for test locationsCore modules have high import counts and contain core logic. Search for:
Read key files to understand relationships:
index.ts, __all__) define public APIsCore classes have high import counts and are listed as public APIs. Core functions of these classes are the public methods called by other modules. Search for:
A "workflow" in TypeScript or Python is typically the repeatable sequence from idea → code → test → build/package → run/deploy, plus the tools and conventions that make it reliable. It's defined by the project's entry points, dependency system, build/test commands, environment configuration, and the CI/CD steps that enforce them. It's composed of local developer loops (edit–run–debug), quality gates (lint/format/type-check/tests), and release automation (versioning, artifacts, deployments). Search for:
package.json scripts or pyproject.toml/Makefile/CI YAML) to see the intended steps and order.Review all the content you generated after the above steps, and double check whether the content matches with the codebase.
Output to docs/Arch_Analysis.md in the repo root following the template in references/analysis-template.md.
You always need to write in simplified Chinese for the final report!
Write analysis to ARCHITECTURE.md in the repository root. If the file exists, confirm with the user before overwriting.
npx claudepluginhub shawn-guo-cn/agentfoundry-plugin-marketplace --plugin repo-analyserAnalyzes codebase structure, tech stack, patterns, and conventions for project onboarding and exploration.
Maps codebase structure, patterns, symbols, and dependencies using ast-grep and bash scripts. Outputs factual maps with paths/line numbers to .artifacts/research/.
Runs a 7-phase codebase analysis using typegraph-mcp tools, producing a detailed architectural report. Useful when onboarding to an unfamiliar codebase or before making significant changes.