codebase-health SKILL.md skillA

codebase-health from tinh2/skills-hub-registry is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tinh2/skills-hub-registry/codebase-health@v2.0.1

Pins v2.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tinh2/skills-hub-registry
Path
analysis/codebase-health/SKILL.md
Versions recorded
4
Latest version
v2.0.1, committed Sep 2, 2026
First version recorded
Mar 1, 2026
Size
11,073 bytes
Repository stars
22
License
none declared

Score your codebase 0-100 across complexity, coupling, cohesion, test coverage, documentation, churn hotspots, dependency health, and lint/type safety. Triggers: 'how healthy is this codebase', 'check code quality', 'score my project', 'find tech debt hotspots'.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

You are an autonomous codebase health assessment agent. You measure the codebase across multiple quality dimensions, produce a composite health score (0-100), and identify the areas most in need of attention.

Do NOT ask the user questions. Investigate the entire codebase thoroughly.

## INPUT

$ARGUMENTS (optional). If provided, focus on specific dimensions or modules (e.g., "complexity only", "src/services", "trends"). If not provided, perform a full health assessment.

---

## PHASE 1: STACK DETECTION AND BASELINE

### 1.1 Identify Tech Stack
- Read package.json, pubspec.yaml, requirements.txt, go.mod, Cargo.toml, Gemfile, pom.xml.
- Identify language(s), framework(s), build tool(s), test framework(s), linter(s).
- Determine if TypeScript/Flow (typed) or JavaScript (untyped).

### 1.2 Gather Baseline Metrics
- Total source files (exclude node_modules, build, dist, vendor, generated).
- Total lines of code (source only).
- Total test files and test lines.
- Project age (first commit date).
- Number of contributors.
- Total commits.

### 1.3 Check for Previous Reports
- Look in MEMORY.md, docs/, or project root for prior scores.
- If found, use as baseline for trend comparison.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tinh2/skills-hub-registry/codebase-health@sha256:f4a3e7890292796c

The line at the top of this page pins the label v2.0.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tdqhdyg4llvbst3t.svg)](https://markdownregistry.com/a/art_tdqhdyg4llvbst3t)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 1, 2026 and Sep 2, 2026, about one every 62 days.

versioncommittedcommitsizeaudit
v2.0.1 latest2026-09-02 5713ecc 11,073 BA view · diff
v2.0.02026-03-18 851800b 11,166 BA view · diff
v1.0.02026-03-13 0aafe73 9,416 BA view · diff
v1.0.02026-03-01 69d4b12 10,664 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11073 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tinh2/skills-hub-registry · 22 stars · license none declared · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tdqhdyg4llvbst3t
GET https://markdownregistry.com/api/v1/resolve?ref=tinh2/skills-hub-registry/codebase-health
GET https://markdownregistry.com/api/v1/blob/f4a3e7890292796c92ac6c981a6b96a69f8d3c240ff94a66866ad8782d640792

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tinh2/skills-hub-registry

508-audit SKILL.md skill
tinh2/skills-hub-registry · analysis/508-audit/SKILL.md · Run a full Section 508 + WCAG 2.2 Level AA accessibility audit on a federal / .gov / public-sector website or ICT…
v1.0.1 · audit A · 22 stars
actuarial-modeling SKILL.md skill
tinh2/skills-hub-registry · analysis/actuarial-modeling/SKILL.md · Analyzes actuarial modeling systems for loss reserving accuracy, premium pricing methodology, mortality/morbidity…
v2.0.1 · audit A · 22 stars
ad-yield-optimization SKILL.md skill
tinh2/skills-hub-registry · analysis/ad-yield-optimization/SKILL.md · Analyzes advertising yield across programmatic and direct-sold inventory including CPM/CPC/CPA performance, header…
v2.0.1 · audit A · 22 stars
affordable-housing SKILL.md skill
tinh2/skills-hub-registry · analysis/affordable-housing/SKILL.md · Analyzes affordable housing management software for unit allocation algorithms, waitlist management, income…
v2.0.1 · audit A · 22 stars
ai-citation-optimizer SKILL.md skill
tinh2/skills-hub-registry · analysis/ai-citation-optimizer/SKILL.md · Rewrites existing landing pages, blog posts, and documentation so AI search engines (Google AI Overviews, ChatGPT…
v1.0.1 · audit B · 22 stars
ai-citation-tracker SKILL.md skill
tinh2/skills-hub-registry · analysis/ai-citation-tracker/SKILL.md · Track brand mentions, URL citations, and share-of-voice across the 2026 AI search surface — ChatGPT (with browsing)…
v1.0.1 · audit A · 22 stars
alert-prioritization SKILL.md skill
tinh2/skills-hub-registry · analysis/alert-prioritization/SKILL.md · Analyzes SIEM alert pipelines for rule optimization, alert fatigue reduction, criticality scoring, asset-based…
v2.0.1 · audit A · 22 stars
analyze SKILL.md skill
tinh2/skills-hub-registry · analysis/analyze/SKILL.md · Deep cross-layer consistency audit for any codebase. Traces every feature from UI to database, finds broken wiring…
v2.0.0 · audit A · 22 stars
api-surface SKILL.md skill
tinh2/skills-hub-registry · analysis/api-surface/SKILL.md · Maps the entire API surface of a codebase -- route definitions, middleware chains, auth requirements, request/response…
v2.0.1 · audit A · 22 stars
app-size-optimizer SKILL.md skill
tinh2/skills-hub-registry · analysis/app-size-optimizer/SKILL.md · Analyzes mobile app binary size -- asset audit for unused images and font subsetting, code stripping with ProGuard and…
v2.0.1 · audit A · 22 stars
app-store-optimization SKILL.md skill
tinh2/skills-hub-registry · analysis/app-store-optimization/SKILL.md · Analyzes App Store and Play Store listing optimization -- keyword research, title optimization, screenshot conversion…
v2.0.1 · audit A · 22 stars
apparel-demand SKILL.md skill
tinh2/skills-hub-registry · analysis/apparel-demand/SKILL.md · Analyzes apparel demand prediction systems for trend forecasting, size curve optimization, color and style analytics…
v2.0.1 · audit A · 22 stars

Every file in tinh2/skills-hub-registry

Browse by kind, by grade A, or by owner.