Can I use this for non-Swift projects?

While the default configuration targets Swift and iOS patterns, the underlying logic can be adapted for other languages by updating the grep patterns.

Does it modify my source code?

No, the skill primarily uses Read, Grep, and Bash tools to analyze the codebase and generates a standalone Markdown report file.

How does this help with project management?

It provides a session summary of bugs fixed and lines changed, alongside a prioritized recommendation list to help plan the next development session.

What specific metrics does this skill track?

It tracks lines of code, file counts, recent Git logs, force unwraps (try!), empty catch blocks, and specific Swift patterns like @Published and UserDefaults usage.

Codebase Health Reporter

Name: Codebase Health Reporter
Author: willsigmon

bywillsigmon

•

Analytics & Monitoring

Generates comprehensive health reports and technical debt audits for Swift-based projects.

Codebase Health Reporter is a specialized skill designed to automate the auditing of iOS and Swift applications by tracking key metrics and code quality indicators. It analyzes lines of code, Git activity, and specific architectural patterns—such as @Published usage, force unwraps, and empty catch blocks—to provide a holistic view of project health. By outputting a structured Markdown report, it helps developers summarize session progress, identify lingering technical debt, and establish prioritized recommendations for future development cycles, making it an essential tool for maintaining high code quality and ensuring ship readiness.

Key Features

01Technical debt identification for force unwraps and empty catches

02Analysis of SwiftUI patterns and UserDefaults usage

036 GitHub stars

04Git contribution and change tracking for session summaries

05Automated Swift codebase auditing and metric collection

06Generation of structured ship-readiness checklists

Use Cases

01Generating end-of-session progress and status reports

02Auditing iOS applications for anti-patterns and technical debt

03Planning future development sprints based on prioritized recommendations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add willsigmon/sigstack codebase-health-reporter

For use in Claude.ai and ChatGPT

Download Skill