Home / cq27-dev / rag-rat · plugin/skills/init-rag-rat/SKILL.md · GitHub

init-rag-rat skillA

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

init-rag-rat is agent-read markdown (skill) from cq27-dev/rag-rat: Use to set up rag-rat in a repository that is not indexed yet — when the rag-rat MCP server is DORMANT (its tools return {"status":"no_index"} with a "Run rag-rat init … then restart" remedy), or when the user asks to initialize / configure / "set up rag-rat" / "index this repo" / choose an embedding backend. Drives the setup conversationally: scans the repo, explains only the material choices, recommends the local FastEmbed default for a modest machine, and — only when a remote / GPU embedder i.

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

# init-rag-rat — configure a dormant rag-rat repo conversationally

rag-rat's MCP server boots **dormant** in a repo with no `rag-rat.toml`: ordinary tools return
`{"status":"no_index", "remedy":"Run rag-rat init … then restart"}`. This skill turns that into a
short guided setup. **You own the conversation; `rag-rat init` owns the scan and validation** — never
hand-write a config blind, and let a real config load re-check it before indexing.

## The common path

1. **Detect state.** You are here because a rag-rat tool returned `status: "no_index"`, or the user
   asked to set up rag-rat. Confirm there is no `rag-rat.toml` at (or above) the repo root. If one
   already exists, this is a *reconfigure* — send the user to the interactive `rag-rat init` wizard
   and stop.

2. **Resolve the CLI** and use the same form throughout, from the **target repo's root**. It must
   match the version the rag-rat MCP server runs, so the index you create is one the server can read —
   do **not** use `@latest`, and **don't blindly trust an on-`PATH` `rag-rat`**:
   - If `rag-rat` is on `PATH`, check `rag-rat --version` and use it **only if it matches** the
…

Read the whole file at its exact version.

How to install

Latest version
mdr add cq27-dev/rag-rat/init-rag-rat@git:20260923.7774461
Exact content
mdr add cq27-dev/rag-rat/init-rag-rat@sha256:41f5b201ff2f1cb2

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.7774461 latest2026-09-23 7774461 8,719 BA view · diff
git:20260913.72dbfb12026-09-13 72dbfb1 7,798 BA view · diff
git:20260910.e0490272026-09-10 e049027 7,798 BA view · diff
git:20260817.81bf9d12026-08-17 81bf9d1 7,798 BA view · diff
git:20260802.e1728c62026-08-02 e1728c6 7,798 BA view · diff
git:20260724.60ca8c52026-07-24 60ca8c5 7,798 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 (8719 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_uyaocywspm5fqqar
GET https://markdownregistry.com/api/v1/resolve?ref=cq27-dev/rag-rat/init-rag-rat
GET https://markdownregistry.com/api/v1/blob/41f5b201ff2f1cb23e102385fde702fc861bd74a5b58033b059b95deca3aef3b

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
using-rag-rat skill
cq27-dev/rag-rat · .agents/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
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
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 init-rag-rat

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

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