codebase-discovery SKILL.md skillA
codebase-discovery from okhp3/skillz is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add okhp3/skillz/codebase-discovery@git:20260828.866dec6Pins git:20260828.866dec6 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- okhp3/skillz
- Path
community/codebase-discovery/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260828.866dec6, committed Aug 28, 2026
- Size
- 10,611 bytes
- Repository stars
- 3
- License
- MIT
Extract domain, architecture, business rules, workflows and a business glossary from an existing (often poorly-documented) codebase, then validate the findings with a senior BA/Product Owner one question at a time. Produces onboarding-grade docs under docs/ that give a new team member — human or AI — enough context to be productive, ready for harness engineering / Spec Kit. Use when onboarding onto an unfamiliar codebase, reverse-engineering business knowledge, reconstructing lost…
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
## User Input ```text $ARGUMENTS ``` You **MUST** consider the user input before proceeding (if not empty). It identifies the codebase (or subsystem) to analyse and, optionally, the mode. --- ## Purpose Reverse-engineer enough business and domain knowledge out of an **existing codebase** to onboard a new team member — human or AI — and to give AI harness tooling (e.g. Spec Kit) the context it needs before any specification or change work begins. The output is a small, lean set of **onboarding documents** under `docs/`, not a comprehensive knowledge base. Each document is written so it can be linked from a `CLAUDE.md` / `AGENTS.md` without consuming an unreasonable amount of context. This skill is the orchestrator. It runs five phases, each defined in its own playbook under `playbooks/`. Read and follow the relevant playbook at each phase. --- ## Core principle > **The code is ground truth for _what_ the system does. Only people hold the _why_.** So the method is: mine the code first to form **evidence-backed hypotheses**, then spend the human's time **validating intent and explaining**, not re-deriving mechanics. Existing …
Read the whole file at its exact version.
How to install
mdr add okhp3/skillz/codebase-discovery@sha256:ab813652857a9d53The line at the top of this page pins the label git:20260828.866dec6, 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.
[](https://markdownregistry.com/a/art_suggqg5r6uv5k6f3)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Aug 28, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10611 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
okhp3/skillz · 3 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_suggqg5r6uv5k6f3 GET https://markdownregistry.com/api/v1/resolve?ref=okhp3/skillz/codebase-discovery GET https://markdownregistry.com/api/v1/blob/ab813652857a9d536b275e96e3e2b0b0f3fe68ce663b84aed1d38dae93684b82
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.