A collection of CodeBuddy skills for understanding and reasoning about codebases.
A deep codebase-cognition skill aimed at engineers, architects, and product owners. Instead of summarizing the directory tree, it rebuilds an evidence-based model of the target repository from its code, configuration, database, tests, and deployment artifacts:
- Product & business — what the system does and what problem it solves.
- Architecture — system boundaries, modules, dependencies, tech stack, and design patterns.
- Core flows — business chains, state transitions, and data lifecycles.
- Evidence conflicts — gaps between docs, comments, config, and actual implementation.
- Engineering review — highlights, hard parts, risks, lessons, and inspirations.
- Roadmap & refactoring — future plans and incremental refactor designs.
- Resume & interview — questions/answers grounded only in real code.
All conclusions are tagged by confidence (FACT / INFERENCE / UNKNOWN /
PROPOSAL) and backed by file-path evidence, so the output can be verified
rather than trusted.
The skill ships a runnable helper that produces a deterministic file inventory used as reconnaissance input:
python3 skills/codebase-insight-v0.1/codebase-insight/scripts/repo_inventory.py <repo-path> -o repo-inventory.jsonskills/
└── codebase-insight-v0.1/
└── codebase-insight/
├── SKILL.md # Skill definition and workflow (Chinese)
├── README.md # Skill-level overview
├── scripts/
│ └── repo_inventory.py
├── tasks/ # 9 step-by-step task guides (01–09)
├── references/ # Evidence, codegraph, diagram, review standards
└── templates/ # Claim ledger and report index templates
Install the skill into your CodeBuddy skills directory and invoke it
(codebase-insight) against any repository you want to understand. Modes:
- Quick — first contact: what it is, how to run it, key entry points.
- Full — architecture review, handover, refactor, due diligence.
- Topic — drill into one chain, service, module, or risk.
See individual skill directories for licensing terms.