Are the complexity thresholds customizable?

Yes, you can define custom warning and critical thresholds for lines per file, functions per file, and complexity scores via a JSON configuration.

How does this skill identify technical debt?

It scans your codebase for specific comment patterns like TODO, FIXME, and HACK, then categorizes them by severity and age to prioritize fixes.

What is the recommended workflow for using this skill?

The workflow involves collecting raw data, calculating derived metrics like test-to-code ratios, identifying hotspots, and finally generating a markdown report with recommendations.

Can I compare current stats with previous versions?

Yes, the skill supports snapshot comparison through a trend comparator tool to track changes in lines of code, complexity, and debt over time.

What metrics are used to identify codebase 'hotspots'?

Hotspots are identified by flagging files with multiple co-occurring issues, such as being both large and complex while also containing many stale TODO items.

Codebase Stats & Technical Debt

Name: Codebase Stats & Technical Debt
Author: ribatshepo

byribatshepo

0•

Analytics & Monitoring

Generates comprehensive codebase metrics and tracks technical debt indicators to maintain long-term project health.

The Codebase Stats skill empowers developers to maintain high-quality software by automating the collection of essential metrics such as lines of code, function complexity, and dependency coupling. By scanning for technical debt indicators like TODO, FIXME, and HACK comments, it provides actionable insights and trend analysis against previous snapshots. It is particularly useful during refactoring phases, architectural reviews, or continuous integration workflows to prevent codebase rot and identify high-risk hotspots that require immediate architectural attention.

Key Features

01Snapshot-based trend comparison to monitor growth over time

02Comprehensive line counting by file type and directory

030 GitHub stars

04Actionable markdown reports with specific refactoring recommendations

05Automated technical debt scanning with severity and age tracking

06Function-level analysis for complexity and documentation coverage

Use Cases

01Monitoring technical debt accumulation during rapid development cycles

02Identifying complex files and functions for targeted refactoring sessions

03Generating standardized codebase health reports for project stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ribatshepo/auto-orchestrate codebase-stats

For use in Claude.ai and ChatGPT

Key Features

01Snapshot-based trend comparison to monitor growth over time

02Comprehensive line counting by file type and directory

030 GitHub stars

04Actionable markdown reports with specific refactoring recommendations

05Automated technical debt scanning with severity and age tracking

06Function-level analysis for complexity and documentation coverage

Use Cases

01Monitoring technical debt accumulation during rapid development cycles

02Identifying complex files and functions for targeted refactoring sessions

03Generating standardized codebase health reports for project stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ribatshepo/auto-orchestrate codebase-stats

For use in Claude.ai and ChatGPT