codebase-modernizer SKILL.md skillA

codebase-modernizer from luongnv89/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add luongnv89/skills/codebase-modernizer@v1.4.1

Pins v1.4.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
luongnv89/skills
Path
skills/codebase-modernizer/SKILL.md
Versions recorded
6
Latest version
v1.4.1, committed Oct 10, 2026
First version recorded
Aug 30, 2026
Size
20,227 bytes
Repository stars
133
License
MIT

Audit a stale, inherited, or messy codebase — deps, bugs, security, tests, CI, docs, UI/UX — then emit a phased, testable modernization plan. Read-only: plans upgrades, never applies them. Not for single-PR review, PRD-to-tasks, or UX-only audits.

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

# Codebase Modernizer

For a codebase you are returning to after a long gap, or one that has drifted through many
unoptimized changes. It audits every applicable dimension, then converts the findings into a
**phased, sprint-sized, testable plan** for a better, up-to-date version.

Produces exactly two files in the target repo root:

| File | Contents |
|---|---|
| `MODERNIZATION_REPORT.md` | Baseline evidence + every finding, severity-ranked, each citing `path:line` |
| `MODERNIZATION_PLAN.md` | Phases → sprints → tasks → milestones, every task closing named findings |

## Read-only contract

This skill **never modifies source code, dependencies, lockfiles, or configuration** — no tracked
file's content changes. On a clean tree that is `git diff --stat` empty. On a stale, already-dirty
tree, `git status --porcelain` and `git diff` after the run must match a snapshot taken before it
(declared artifacts set aside). Beyond the two reports, only two kinds of *new* file may appear,
both enumerated in the report's Artifacts section: a **declared delegate artifact**
(`CODE_REVIEW.md`, from `code-review` mode `review`) and **probe byproducts** (build dirs such as
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add luongnv89/skills/codebase-modernizer@sha256:d209f0158d959840

The line at the top of this page pins the label v1.4.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_6xqpac3ek4pmkidc.svg)](https://markdownregistry.com/a/art_6xqpac3ek4pmkidc)

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

Versions

The registry has recorded 6 versions of this file, between Aug 30, 2026 and Oct 10, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
v1.4.1 latest2026-10-10 e514aaa 20,227 BA view · diff
v1.4.02026-10-06 81e6fbf 20,227 BA view · diff
v1.3.32026-10-01 c1c53b9 20,490 BA view · diff
v1.3.22026-09-26 f2d2eb9 20,459 BA view · diff
v1.3.12026-09-26 210cfae 20,831 BA view · diff
v1.3.02026-08-30 a387ead 20,458 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 (20227 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

luongnv89/skills · 133 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6xqpac3ek4pmkidc
GET https://markdownregistry.com/api/v1/resolve?ref=luongnv89/skills/codebase-modernizer
GET https://markdownregistry.com/api/v1/blob/d209f0158d9598404eefc4b3e1e616cdee3501d8316f194fcfe2fed8a9e7254a

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 luongnv89/skills

AGENTS.md AGENTS.md file
luongnv89/skills · AGENTS.md
git:20261010.f8bb4a8 · audit A · 133 stars
CLAUDE.md CLAUDE.md file
luongnv89/skills · CLAUDE.md
git:20261001.c1c53b9 · audit B · 133 stars
agent-config SKILL.md skill
luongnv89/skills · skills/agent-config/SKILL.md · Create, update, or audit AGENTS.md (default) or CLAUDE.md agent instructions: set up, prune, add a rule, or merge…
v2.2.0 · audit A · 133 stars
ai-job-scout SKILL.md skill
luongnv89/skills · skills/ai-job-scout/SKILL.md · Find open AI engineering jobs that fit a candidate, verify location and apply links, and assess each employer's…
v1.1.1 · audit A · 133 stars
appstore-assets SKILL.md skill
luongnv89/skills · skills/appstore-assets/SKILL.md · Generate App Store screenshots and header/search images for iPhone, iPad and Mac from a codebase or landing page, or…
v1.0.0 · audit A · 133 stars
appstore-review-checker SKILL.md skill
luongnv89/skills · skills/appstore-review-checker/SKILL.md · Audit iOS/macOS apps against App Store Review Guidelines before submission, with evidence-backed verdicts and fixes…
v1.5.0 · audit A · 133 stars
aso-marketing SKILL.md skill
luongnv89/skills · skills/aso-marketing/SKILL.md · Optimize App Store and Google Play listings via a 7-phase, plan-approval-gated ASO workflow (keyword strategy…
v1.4.0 · audit A · 133 stars
auto-push SKILL.md skill
luongnv89/skills · skills/auto-push/SKILL.md · Generate a commit message, stage all changes, and push to remote after scanning for secrets, large files, and…
v1.1.1 · audit A · 133 stars
brand-name-checker SKILL.md skill
luongnv89/skills · skills/brand-name-checker/SKILL.md · Check product and brand names for conflicts across trademarks, domains, social handles, and package registries. Returns…
v1.5.0 · audit A · 133 stars
cleanup-project SKILL.md skill
luongnv89/skills · skills/cleanup-project/SKILL.md · Prepare a git repo before new work: review uncommitted changes, fix .gitignore, delete merged branches, end on clean…
v1.0.2 · audit A · 133 stars
cli-builder SKILL.md skill
luongnv89/skills · skills/cli-builder/SKILL.md · Build production-quality CLIs with language detection and a five-step approval-gated workflow. Use when wrapping an…
v1.3.0 · audit A · 133 stars
code-review SKILL.md skill
luongnv89/skills · skills/code-review/SKILL.md · Review or improve code — one skill, four modes: bug/security review (default), performance, clean-code audit, slop…
v2.2.2 · audit A · 133 stars

Every file in luongnv89/skills

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