codebase-inspection

Analyze repositories for line counts, language distributions, and code-to-comment ratios using pygount.

7|1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/paxlabs-inc/ion-agent --skill codebase-inspection-paxlabs-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/paxlabs-inc/ion-agent/tree/main/skills/github/codebase-inspection
Command: npx skills add https://github.com/paxlabs-inc/ion-agent --skill codebase-inspection-paxlabs-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount.

What problem does it solve?

This skill eliminates the manual effort required to audit repository size, language distribution, and code-to-comment ratios, providing immediate visibility into project complexity.

Core Features & Use Cases

  • Language Breakdown: Automatically identify the programming languages present in a repository and their respective file counts.
  • Metric Analysis: Calculate precise lines of code (LOC) and code-to-comment ratios to assess documentation quality.
  • Use Case: When onboarding to a new project, use this skill to quickly understand the tech stack and the scale of the codebase before diving into the implementation details.

Quick Start

Use the codebase-inspection skill to generate a summary report of the current repository while excluding all dependency and build folders.

Frequently Asked Questions about codebase-inspection

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

FAQPage Schema
How do I calculate lines of code and language distribution for a software repository?

To calculate lines of code for a software repository, you can use this skill to automatically parse source files and generate metrics. It analyzes the codebase to provide precise line counts, language breakdowns, and file counts.

Can I analyze code-to-comment ratios while excluding dependency folders?

You can analyze code-to-comment ratios while excluding dependency folders by applying configurable folder exclusion patterns. This ignores build artifacts and dependencies, ensuring metrics accurately reflect your custom source code.

What is the best way to audit project complexity before onboarding to a new codebase?

Auditing project complexity before onboarding involves generating a summary report of the repository's scale and tech stack. This skill instantly provides language distributions and code-to-comment ratios to help you understand the codebase.

Do I need to install pygount to perform source code parsing and metric generation?

You do need to install the pygount package to perform accurate source code parsing and metric generation. This dependency is required for the skill to analyze the repository and calculate the codebase metrics.

Does pygount work with diverse project types for calculating lines of code?

Pygount works with diverse project types for calculating lines of code by supporting configurable folder exclusion patterns. This allows you to accurately analyze various repository structures while ignoring irrelevant build outputs.