codebase-review SKILL.md skillA

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

Install it, pinned
mdr add timharris707/skills/codebase-review@git:20261008.0b04f1c

Pins git:20261008.0b04f1c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
timharris707/skills
Path
skills/investigate/codebase-review/SKILL.md
Versions recorded
5
Latest version
git:20261008.0b04f1c, committed Oct 8, 2026
First version recorded
Aug 12, 2026
Size
11,485 bytes
Repository stars
44
License
MIT

Run a state review of the codebase: the counterpart to adversarial-review's change review. Use before building against an upcoming spec (make the change easy first), when lanes merged since the last review cross the repo's threshold, or when lanes or the orchestrator report the code fighting them.

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 review

A review of what the codebase **is**, where [adversarial-review](../../run/adversarial-review/SKILL.md) reviews what a diff changes. It hunts **deepening opportunities**: places where structure taxes every change that passes through. It ends only when the decider has dispositioned every surviving candidate.

This skill is the portable protocol: an entry gate, a read-only review lane of finders each named for the lens it looks through, a skeptic pass that kills candidates before the report exists, and the disposition loop. Everything repo-specific lives in **binding slots** the team-workflow setup interview fills: where reports land, the trigger threshold, where rejections are remembered, how the lane is run.

Read the team-workflow binding doc first. Full domain-modeling discipline (glossaries, decision records) lives in [domain-memory](../../orient/domain-memory/SKILL.md), deliberately not here.

## 1. Triggers: an entry gate, never a calendar

The review runs when one of three gates opens, never on a schedule: a scheduled run reviews whatever the calendar happens to land on, and produces findings to match.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add timharris707/skills/codebase-review@sha256:3c7d244c9f9a7d84

The line at the top of this page pins the label git:20261008.0b04f1c, 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_jwf5t33hgxpdllmw.svg)](https://markdownregistry.com/a/art_jwf5t33hgxpdllmw)

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

Versions

The registry has recorded 5 versions of this file, between Aug 12, 2026 and Oct 8, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261008.0b04f1c latest2026-10-08 0b04f1c 11,485 BA view · diff
git:20260826.43e4f182026-08-26 43e4f18 11,378 BA view · diff
git:20260819.051499c2026-08-19 051499c 11,376 BA view · diff
git:20260819.b5bf4cd2026-08-19 b5bf4cd 11,346 BA view · diff
git:20260812.896d9e02026-08-12 896d9e0 11,483 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 (11485 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

timharris707/skills · 44 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jwf5t33hgxpdllmw
GET https://markdownregistry.com/api/v1/resolve?ref=timharris707/skills/codebase-review
GET https://markdownregistry.com/api/v1/blob/3c7d244c9f9a7d846b5963eac008193a1a29f82c18f2f4ac395fce81562529b0

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

CLAUDE.md CLAUDE.md file
timharris707/skills · CLAUDE.md
git:20260906.c7e0ad4 · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · editions/codex/overrides/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
huh SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/huh/SKILL.md · When a message did not land or pasted agent output needs translation, restate it plainly, expand shorthand, separate…
git:20260906.a9317e0 · audit A · 44 stars
plainspoken SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/plainspoken/SKILL.md · For chat replies, status updates, review comments, and commit messages, write plainly without AI tells. Also use to…
git:20260906.a9317e0 · audit A · 44 stars
writing-for-agents SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-agents/SKILL.md · For skills, standing agent instructions, recorded rules, or documents agents skip, write and prune reliable triggers…
git:20261008.0b04f1c · audit A · 44 stars
writing-for-humans SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-humans/SKILL.md · For public-facing drafts, pages that read like agent documentation, or a final AI-tell scrub, write clear human copy in…
git:20260906.a9317e0 · audit A · 44 stars
advisory-board SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/advisory-board/SKILL.md · For an explicitly requested advisory board, roundtable, panel, idea tournament, multi-model review or debate, red-team…
git:20260906.a9317e0 · audit B · 44 stars
decision-map SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/decision-map/SKILL.md · When asked to chart a decision map, work a map ticket, or plan work whose open decisions gate each other, map the…
git:20261009.3cdacee · audit A · 44 stars
grilling SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/grilling/SKILL.md · When asked to grill, stress-test, or pressure-test an idea, or before a decision map or spec rests on an untested…
git:20261008.0b04f1c · audit A · 44 stars
codebase-review SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/codebase-review/SKILL.md · Before an upcoming feature, when merged work crosses the recorded review threshold, or when implementation exposes…
git:20261008.0b04f1c · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
prototype SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/prototype/SKILL.md · When discussion or static mockups cannot settle how something should look, behave, or feel, build a disposable…
git:20260906.a9317e0 · audit A · 44 stars

Every file in timharris707/skills

Other files named codebase-review

codebase-review SKILL.md skill
hoangnguyen0403/agent-skills-standard · .codex/skills/codebase-review/SKILL.md · Review an entire codebase for architecture, engineering health, and exploitable risk; generate a prioritized…
git:20260929.1450937 · audit A · 578 stars
codebase-review SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/codebase-review/SKILL.md · Before an upcoming feature, when merged work crosses the recorded review threshold, or when implementation exposes…
git:20261008.0b04f1c · audit A · 44 stars

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