codebase-inspection

Compute lines of code, file counts, and language breakdowns with pygount.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/devMoez/titan --skill codebase-inspection-devmoez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/devMoez/titan/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/devMoez/titan --skill codebase-inspection-devmoez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve?

Codebase inspection removes the guesswork around how big a repository is, what languages dominate it, and how much of the content is code versus comments.

Core Features & Use Cases

  • LOC and language breakdown: Estimates total files and line counts per detected language using pygount.
  • Code-vs-comment ratios: Highlights the proportion of executable/declarative lines versus comments/docs.
  • Practical repo auditing: Quickly answers “how large is this repo?”, “what tech stack is it?”, and “is documentation heavy?” before planning refactors or reviews.

Quick Start

Ask the agent to inspect a local repository folder at /path/to/repo and return a pygount --format=summary style LOC and language breakdown with dependency folders skipped.

Frequently Asked Questions about codebase-inspection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a language breakdown and LOC for a local repository folder?▼

To get a language breakdown and LOC for a local repository folder, the Skill analyzes your Git checkout using pygount to compute total files, line counts per detected language, and code-to-comment ratios.

What is the code-to-comment ratio in a codebase and how is it calculated?▼

The code-to-comment ratio measures the proportion of executable or declarative lines versus comments and documentation. This Skill calculates it using pygount to highlight documentation intensity across software projects.

Does pygount support skipping dependency folders during a codebase inspection?▼

Yes, pygount supports skipping dependency folders during a codebase inspection. The Skill applies appropriate --folders-to-skip exclusions to ensure dependency directories do not skew your repository analytics.

Can I use this to audit a local clone before planning a refactor?▼

Yes, you can use this to audit a local clone before planning a refactor. It provides quick estimates of repository size, tech stack composition, and documentation intensity to support your review process.

What is the best way to generate machine-readable repository analytics for downstream analysis?▼

The best way to generate machine-readable repository analytics is to run pygount with a non-summary output format. The Skill produces machine-readable outputs from your target directory to support downstream analysis.