codebase-analysis

timmye's avatarfrom timmye

Invoke IMMEDIATELY via python script when user requests codebase analysis, architecture review, security assessment, or quality evaluation. Do NOT explore first - the script orchestrates exploration.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 6, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill automates comprehensive codebase analysis, architecture reviews, and security assessments through a specialized Python orchestration script. It streamlines the evaluation of code quality and structural integrity by providing a structured, multi-step exploration process that ensures deep technical insights without manual overhead.

Use Cases

  • Architecture Review: Evaluating the structural design and design patterns of a repository to ensure scalability and best practices.
  • Security Assessment: Identifying potential vulnerabilities, sensitive data leaks, and security flaws within an existing codebase.
  • Quality Evaluation: Performing deep-dives into code maintainability, technical debt, and adherence to industry coding standards.
  • Codebase Onboarding: Rapidly understanding the logic, dependencies, and flow of a complex or unfamiliar project through automated exploration.
namecodebase-analysis
descriptionInvoke IMMEDIATELY via python script when user requests codebase analysis, architecture review, security assessment, or quality evaluation. Do NOT explore first - the script orchestrates exploration.

Codebase Analysis

When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.

Invocation

python3 scripts/analyze.py \
  --step-number 1 \
  --total-steps 6 \
  --thoughts "Starting analysis. User request: <describe what user asked to analyze>"
Argument Required Description
--step-number Yes Current step (starts at 1)
--total-steps Yes Minimum 6; adjust as script instructs
--thoughts Yes Accumulated state from all previous steps

Do NOT explore or analyze first. Run the script and follow its output.