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
plugins/clickai-codex/skills/investigate/codebase-review/SKILL.md
Versions recorded
3
Latest version
git:20261008.0b04f1c, committed Oct 8, 2026
First version recorded
Sep 5, 2026
Size
12,162 bytes
Repository stars
44
License
MIT

Before an upcoming feature, when merged work crosses the recorded review threshold, or when implementation exposes structural friction, review the codebase state with independent skepticism. Deliver the report while keeping unresolved adoption decisions tracked.

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

Read the [Codex desktop binding](../../../CODEX.md) when this workflow needs harness mechanics, model routing, or recovery.

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. The review completes with an evidence-backed report; adoption decisions can remain pending on the tracker.

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
…

Read the whole file at its exact version.

How to install

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

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_fzag5lptnu74lr5p.svg)](https://markdownregistry.com/a/art_fzag5lptnu74lr5p)

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

Versions

The registry has recorded 3 versions of this file, between Sep 5, 2026 and Oct 8, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20261008.0b04f1c latest2026-10-08 0b04f1c 12,162 BA view · diff
git:20260906.a9317e02026-09-06 a9317e0 12,013 BA view · diff
git:20260905.b0748d82026-09-05 b0748d8 11,690 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 (12162 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_fzag5lptnu74lr5p
GET https://markdownregistry.com/api/v1/resolve?ref=timharris707/skills/codebase-review
GET https://markdownregistry.com/api/v1/blob/bb61c914ce887c4667ceae555f4860f39d0c5a7c1b6cc2a609adb1e336d42e3e

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
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
research SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/research/SKILL.md · For factual investigations of vendor materials, regulations, upstream repositories, recorded calls, or other evidence…
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 · skills/investigate/codebase-review/SKILL.md · Run a state review of the codebase: the counterpart to adversarial-review's change review. Use before building against…
git:20261008.0b04f1c · audit A · 44 stars

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