workflow-codebase-knowledge SKILL.md skillA

workflow-codebase-knowledge from lugassawan/swe-workbench is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lugassawan/swe-workbench/workflow-codebase-knowledge@git:20260820.16e7f08

Pins git:20260820.16e7f08 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lugassawan/swe-workbench
Path
skills/workflow-codebase-knowledge/SKILL.md
Versions recorded
4
Latest version
git:20260820.16e7f08, committed Aug 20, 2026
First version recorded
May 17, 2026
Size
6,321 bytes
Repository stars
3
License
MIT

Use to understand an unfamiliar codebase — presents architecture overview, module map, public API surfaces, and conventions as a layered mental model. Knowledge-presentation only — read-only sweep, no defect ranking, no reasoning chains. Distinct from workflow-codebase-audit (finding-oriented defect detection) and tech-writer / /swe-workbench:document (generates new prose artifacts). Ideal for onboarding, knowledge-handoff, and reviewer context-gathering.

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

# Workflow: Codebase Knowledge

**Announce at start:** "Activating `swe-workbench:workflow-codebase-knowledge` to present a structured knowledge document."

## When to invoke

- Onboarding to an unfamiliar codebase: "walk me through this repo."
- Knowledge-handoff request: "give the incoming engineer a mental model of the service."
- Reviewer context-gathering: "what are the public API surfaces before I start the PR review?"
- Architecture exploration: "show me the module boundaries and their relationships."

## When NOT to invoke

- **Defect detection or ranked findings** → use `swe-workbench:workflow-codebase-audit` (cold-start multi-axis sweep with reasoning chains and severity ranking).
- **Generating new prose documentation** (READMEs, ADRs, ARCHITECTURE files) → use `/swe-workbench:document` which delegates to the `swe-workbench:tech-writer` subagent.
- **Known bug with a repro** → use `/swe-workbench:debug`.
- **PR diff review** → use `/swe-workbench:review`.

## Composition

Read-only sweep — no subagents dispatched. May delegate file discovery to `Explore` agents in parallel for breadth when the path scope is wide. Never writes to disk.

## Path argument
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lugassawan/swe-workbench/workflow-codebase-knowledge@sha256:46a4d38d6bb1d5d8

The line at the top of this page pins the label git:20260820.16e7f08, 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_rna2rnhhyyniqh7w.svg)](https://markdownregistry.com/a/art_rna2rnhhyyniqh7w)

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

Versions

The registry has recorded 4 versions of this file, between May 17, 2026 and Aug 20, 2026, about one every 32 days.

versioncommittedcommitsizeaudit
git:20260820.16e7f08 latest2026-08-20 16e7f08 6,321 BA view · diff
git:20260811.925e30f2026-08-11 925e30f 6,318 BA view · diff
git:20260702.cb2392a2026-07-02 cb2392a 6,276 BA view · diff
git:20260517.903a7242026-05-17 903a724 6,262 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 (6321 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

lugassawan/swe-workbench · 3 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rna2rnhhyyniqh7w
GET https://markdownregistry.com/api/v1/resolve?ref=lugassawan/swe-workbench/workflow-codebase-knowledge
GET https://markdownregistry.com/api/v1/blob/46a4d38d6bb1d5d8fdecdca0944b162ab8613f8fdaa7505f9b9b570bc4a55d32

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 lugassawan/swe-workbench

comms-context SKILL.md skill
lugassawan/swe-workbench · skills/comms-context/SKILL.md · Fetch on-call and discussion context from Slack threads and PagerDuty incidents — participants, timeline, and status…
git:20260828.71a6399 · audit A · 3 stars
language-bash SKILL.md skill
lugassawan/swe-workbench · skills/language-bash/SKILL.md · Bash idioms — strict mode, parameter expansion, arrays, trap cleanup, heredocs, and POSIX portability. Auto-load when…
git:20260828.71a6399 · audit A · 3 stars
language-csharp SKILL.md skill
lugassawan/swe-workbench · skills/language-csharp/SKILL.md · C# and .NET idioms — .NET 8 LTS, C# NRT, records, value semantics, switch expressions, async/await, Task, ValueTask…
git:20260828.71a6399 · audit A · 3 stars
language-dart SKILL.md skill
lugassawan/swe-workbench · skills/language-dart/SKILL.md · Dart idioms — null safety, Futures and Streams, widget composition, and Riverpod app architecture. Auto-load when…
git:20260828.71a6399 · audit A · 3 stars
language-go SKILL.md skill
lugassawan/swe-workbench · skills/language-go/SKILL.md · Go idioms — error handling, concurrency, and standard library usage. Auto-load when working with .go files, go.mod…
git:20260828.71a6399 · audit A · 3 stars
language-java SKILL.md skill
lugassawan/swe-workbench · skills/language-java/SKILL.md · Java idioms — records, sealed types, virtual threads, and JDK 21+ patterns. Auto-load when working with .java files…
git:20260828.71a6399 · audit A · 3 stars
language-kotlin SKILL.md skill
lugassawan/swe-workbench · skills/language-kotlin/SKILL.md · Kotlin idioms — null safety, sealed interfaces, scope functions, and Flow. Auto-load when working with .kt files…
git:20260828.71a6399 · audit A · 3 stars
language-python SKILL.md skill
lugassawan/swe-workbench · skills/language-python/SKILL.md · Python idioms — PEP 8, context managers, generators, asyncio, and testing. Auto-load when working with .py files…
git:20260828.71a6399 · audit A · 3 stars
language-ruby SKILL.md skill
lugassawan/swe-workbench · skills/language-ruby/SKILL.md · Ruby idioms — Ruby 3.x pattern matching, procs, Comparable, error handling, and testing. Auto-load when working with…
git:20260828.71a6399 · audit A · 3 stars
language-rust SKILL.md skill
lugassawan/swe-workbench · skills/language-rust/SKILL.md · Rust idioms — ownership, lifetimes, and iterators. Auto-load when working with .rs files, Cargo.toml, or when the user…
git:20260828.71a6399 · audit A · 3 stars
language-sql SKILL.md skill
lugassawan/swe-workbench · skills/language-sql/SKILL.md · SQL idioms — query tuning, table definitions, constraints, transactions, and pagination. Auto-load when working with…
git:20260828.71a6399 · audit A · 3 stars
language-swift SKILL.md skill
lugassawan/swe-workbench · skills/language-swift/SKILL.md · Swift idioms — optionals, value types, async/await, and Result builders. Auto-load when working with .swift files…
git:20260828.71a6399 · audit A · 3 stars

Every file in lugassawan/swe-workbench

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