codebase-inspection

Calculate lines of code, language composition, and code-to-comment ratios with pygount.

3|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/DarkArty07/Aether-Agents --skill codebase-inspection-darkarty07
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/DarkArty07/Aether-Agents/tree/main/home/skills/github/codebase-inspection
Command: npx skills add https://github.com/DarkArty07/Aether-Agents --skill codebase-inspection-darkarty07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually counting lines of code, identifying language composition, and calculating code-to-comment ratios for repositories is time-consuming and error-prone, especially for large codebases with nested dependency and build folders.

Core Features & Use Cases

  • Automated Code Metrics: Uses pygount to scan repositories and generate accurate lines of code, file counts, and language breakdowns, with built-in exclusions for common folders like .git, node_modules, and venv to avoid scanning irrelevant files.
  • Targeted Language Filtering: Filter analysis results by specific programming languages to focus on relevant parts of a codebase, ideal for evaluating new open source projects, assessing technical debt, or generating segment-specific development reports.
  • Flexible Output Formats: Supports human-readable summary tables for quick insights and JSON output for programmatic use in scripts, dashboards, or automated reporting workflows.

Quick Start

Use the codebase-inspection skill to analyze the lines of code, language distribution, and code-to-comment ratios for the current repository.

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I count lines of code and get a language breakdown for a repository?

To count lines of code and get a language breakdown, this skill uses the pygount command-line tool to scan repository files, automatically excluding dependency folders like node_modules and venv. It generates structured summary tables or JSON output containing code metrics.

How do I calculate the code-to-comment ratio for my codebase?

Calculating the code-to-comment ratio for a codebase is done by applying pygount to scan source files and measure comment density against executable lines. The skill outputs these ratios alongside file counts to support technical debt assessment.

Can I exclude build and dependency directories when analyzing code metrics?

Yes, you can exclude build and dependency directories when analyzing code metrics. The skill features built-in exclusions for common irrelevant folders like .git, node_modules, venv, and build directories to ensure accurate repository inspection.

Does this codebase analysis tool support JSON output for automated reporting?

Yes, the codebase analysis tool supports JSON output for automated reporting. It provides flexible output formats, allowing you to generate human-readable summary tables for quick insights or JSON data for programmatic use in scripts and dashboards.

What is the best way to evaluate technical debt using code metrics?

Evaluating technical debt using code metrics is best achieved by scanning repository files to calculate lines of code and code-to-comment ratios. This skill filters analysis by specific programming languages to focus on relevant segments for segment-specific development reports.

Can I filter codebase analysis results by a specific programming language?

Yes, you can filter codebase analysis results by specific programming languages. This targeted language filtering allows you to focus on relevant parts of a codebase, which is ideal for evaluating new open source projects or assessing technical debt.