Home / cq27-dev / rag-rat · .agents/skills/using-rag-rat/SKILL.md · GitHub

using-rag-rat skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, same audit grade.

using-rag-rat is agent-read markdown (skill) from cq27-dev/rag-rat: Use when working in a repository indexed by rag-rat (a `rag-rat.toml` at the root and a rag-rat MCP server available). Establishes the working rule: reach for the rag-rat MCP tools (semantic_search, symbol_lookup, impact_surface, find_callers/trace_callees, repo_brief, important_symbols) to FIND and UNDERSTAND code before falling back to grep/cat, and record durable, non-obvious learnings as rag-rat memories before finishing. Triggers: "use rag-rat", "how do I navigate this repo", any code-under.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# using-rag-rat — navigate with the MCP, remember what you learn

This repo is indexed by **rag-rat**, a local repo-intelligence index + MCP server. One MCP call
returns graph (callers/callees), git, GitHub papertrail, and **drive-by repo memories**
(source-anchored invariants, decisions, risks) — all validated against current source. A `grep`
can't surface any of that. Two rules follow.

## Rule 1 — Find and understand through the MCP, not a shell sweep

Prefer these over `grep`/`cat`/file sweeps when browsing or understanding code:

- **`semantic_search`** — "where is this concept implemented?" Current source chunks with inline
  graph, git, and papertrail.
- **`symbol_lookup`** — exact/fuzzy symbol resolution (Rust/TS/Kotlin/C/C++/Python/Swift/Go), with
  any bound memories attached.
- **`impact_surface`** — the **coding preflight before editing any non-trivial symbol**: callers,
  callees, tests, git history, papertrail, and the repo memories crossing that call path. Run it
  before you change something load-bearing — it's how you avoid missing an invariant.
- **`find_callers` / `trace_callees`** — reverse/forward graph traversal instead of grepping for
  call sites.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add cq27-dev/rag-rat/using-rag-rat@git:20260923.d7898ea
Exact content
mdr add cq27-dev/rag-rat/using-rag-rat@sha256:856212bdcc4b127c

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_knu5e6brq4wjev6b.svg)](https://markdownregistry.com/a/art_knu5e6brq4wjev6b)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.d7898ea latest2026-09-23 d7898ea 10,459 BA view · diff
git:20260923.4596f502026-09-23 4596f50 10,353 BA view · diff
git:20260806.f87a5a12026-08-06 f87a5a1 10,104 BA view · diff
git:20260806.bb71dac2026-08-06 bb71dac 9,643 BA view · diff
git:20260730.be80f5a2026-07-30 be80f5a 8,428 BA view · diff
git:20260730.296ed102026-07-30 296ed10 7,215 BA view · diff
git:20260712.6e2cf222026-07-12 6e2cf22 7,206 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (10459 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

cq27-dev/rag-rat · 20 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_knu5e6brq4wjev6b
GET https://markdownregistry.com/api/v1/resolve?ref=cq27-dev/rag-rat/using-rag-rat
GET https://markdownregistry.com/api/v1/blob/856212bdcc4b127c2af51e86e2133079f1044bec7a223817bdd9f55513d2d2fd

Your agent 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.

More from cq27-dev/rag-rat

configure-rag-rat-dream skill
cq27-dev/rag-rat · .agents/skills/configure-rag-rat-dream/SKILL.md · Use to enable and operate rag-rat's optional AI memory-maintenance passes — the `dream --verify` / `--compact` model…
git:20260711.a2328dc · audit A · 20 stars
dream-review skill
cq27-dev/rag-rat · .agents/skills/dream-review/SKILL.md · Use when asked to review, triage, or resolve rag-rat "dream" findings — the memory-maintenance worklist the `dream`…
git:20260923.d7898ea · audit A · 20 stars
init-rag-rat skill
cq27-dev/rag-rat · .agents/skills/init-rag-rat/SKILL.md · Use to set up rag-rat in a repository that is not indexed yet — when the rag-rat MCP server is DORMANT (its tools…
git:20260923.7774461 · audit A · 20 stars
rust-modern-style skill
cq27-dev/rag-rat · .agents/skills/rust-modern-style/SKILL.md · Apply rag-rat's Rust style when writing or reviewing Rust: current stable idioms, module-qualified free functions and…
git:20260728.7d950c9 · audit A · 20 stars
AGENTS.md agents
cq27-dev/rag-rat · AGENTS.md
git:20260923.5873be4 · audit A · 20 stars
CLAUDE.md claude
cq27-dev/rag-rat · CLAUDE.md
git:20260609.b6c71a8 · audit B · 20 stars
configure-rag-rat-dream skill
cq27-dev/rag-rat · plugin/skills/configure-rag-rat-dream/SKILL.md · Use to enable and operate rag-rat's optional AI memory-maintenance passes — the `dream --verify` / `--compact` model…
git:20260711.a2328dc · audit A · 20 stars
dream-review skill
cq27-dev/rag-rat · plugin/skills/dream-review/SKILL.md · Use when asked to review, triage, or resolve rag-rat "dream" findings — the memory-maintenance worklist the `dream`…
git:20260923.d7898ea · audit A · 20 stars
init-rag-rat skill
cq27-dev/rag-rat · plugin/skills/init-rag-rat/SKILL.md · Use to set up rag-rat in a repository that is not indexed yet — when the rag-rat MCP server is DORMANT (its tools…
git:20260923.7774461 · audit A · 20 stars
using-rag-rat skill
cq27-dev/rag-rat · plugin/skills/using-rag-rat/SKILL.md · Use when working in a repository indexed by rag-rat (a `rag-rat.toml` at the root and a rag-rat MCP server available)…
git:20260923.d7898ea · audit A · 20 stars

Every file in cq27-dev/rag-rat

Other files named using-rag-rat

using-rag-rat skill
cq27-dev/rag-rat · plugin/skills/using-rag-rat/SKILL.md · Use when working in a repository indexed by rag-rat (a `rag-rat.toml` at the root and a rag-rat MCP server available)…
git:20260923.d7898ea · audit A · 20 stars

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