codebase-inspection

Analyze codebases for lines of code, language composition, and code-comment ratios using pygount.

9|3|Updated May 18, 2026
One-click install
npx skills add https://github.com/jordanhubbard/mac --skill codebase-inspection-jordanhubbard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-inspection
Source: https://github.com/jordanhubbard/mac/tree/main/src/mac/_hermes/skills/github/codebase-inspection
Command: npx skills add https://github.com/jordanhubbard/mac --skill codebase-inspection-jordanhubbard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pygount, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a fast and efficient way to analyze codebases, giving insights into lines of code, language composition, and code-comment ratios.

Core Features & Use Cases

  • Lines of Code (LOC) Count: Get a comprehensive breakdown of the number of lines of code in a repository.
  • Language Breakdown: Understand the distribution of programming languages within a codebase.
  • Code-Comment Ratios: Assess the balance between code and comments in a repository.
  • Use Case: When you need to quickly evaluate the size and complexity of a codebase before taking on a new project or contributing to an existing one.

Quick Start

Run the codebase-inspection skill on your repository to get a summary of LOC, languages, and ratios.

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?▼

You can count lines of code and get a language breakdown by analyzing your repository to generate statistics on LOC, language composition, and code-comment ratios using the pygount library.

What is a code-comment ratio and when do I need to assess it?▼

A code-comment ratio measures the balance between code and comments in a repository. You need to assess this ratio during code health assessments or project planning to evaluate documentation quality and maintainability.

How do I quickly evaluate the size and complexity of a codebase before contributing?▼

To evaluate codebase size and complexity before contributing, analyze the repository to obtain a comprehensive breakdown of lines of code, language distribution, and code-comment ratios for a quick health assessment.

Does pygount work for analyzing multiple programming languages in a single codebase?▼

Yes, pygount works for analyzing multiple programming languages in a single codebase by processing the repository and generating a language composition breakdown showing the distribution of all detected programming languages.

Can I use codebase inspection for project planning and repository reviews?▼

Yes, you can use codebase inspection for project planning and repository reviews. It provides fast insights into lines of code, language composition, and code-comment ratios to evaluate project scope and health.