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.