/repomix-context-skill

name: repomix-context-skill
description: Use when an agent needs source code from the local repomix index under .terrain/agent/repomix.md (not committed; regenerate via Terrain scan).
version: 1.3.0

Repomix Context Skill

Terrain stores a **local repomix index** at `.terrain/agent/repomix.md` (gitignored, fast to regenerate).

Read **architecture first** via `terrain-knowledge-skill` → `.terrain/agent/context.md`.

When to use

• Implementation details after reading `context.md`
• Cross-file symbol search within the indexed snapshot
• Locating handlers, types, routes

Query strategy (mandatory)

1. **Read meta** — `.terrain/agent/meta.json` (`total_tokens`, `synced_at`, `top_files_by_tokens`) 2. **Search the pack** — never load the entire file:

   # <rtk> = ~/.terrain/bin/rtk or bunx @terrain-ai/rtk (see rtk-skill)
   <rtk> grep "struct ProjectOverview" .terrain/agent/repomix.md
   <rtk> grep "### src/lib/api.ts" .terrain/agent/repomix.md

Or agent Grep limited to that path with tight patterns. 3. **Read slices** — extract matching `### path/to/file` sections only:

   <rtk> read .terrain/agent/repomix.md -l aggressive

Then read the specific `### file` block (line range), ≤150 lines per read. 4. **Refresh** — if `meta.json.synced_at` is stale, ask user to run Terrain **重建源码索引** / scan

Repomix section format

Sections look like:

### src/lib/foo.ts

\`\`\`typescript
... file content ...
\`\`\`

Grep for `### relative/path` to jump to a file.

Paths

| File | Purpose | |------|---------| | `.terrain/agent/repomix.md` | Full indexed snapshot (local only) | | `.terrain/agent/meta.json` | Pack metrics | | `.terrain/agent/context.md` | Architecture (read first) |

Do not

• Commit or assume `repomix.md` exists in git
• `cat` / Read the entire `repomix.md` (can be 100k+ tokens)
• Read the live repository tree when the pack covers the question
• Skip `context.md` and grep source for architecture questions

Regenerate index

If `repomix.md` is missing:

# bash / Git Bash — <terrain> = ~/.terrain/bin/terrain or bunx @terrain-ai/cli
if [ -x ~/.terrain/bin/terrain ] || [ -x ~/.terrain/bin/terrain.exe ]; then
  ~/.terrain/bin/terrain assets pack-agent .
else
  bunx @terrain-ai/cli assets pack-agent .
fi
# or from repo root in Terrain UI: 重建源码索引

If neither `~/.terrain/bin/terrain` nor `bunx @terrain-ai/cli` works, ask the user to install Terrain or run **重建源码索引** from the desktop app.

Related skills

• **codegraph-skill** — symbol relationships (prefer before wide repomix grep)
• **rtk-skill** — resolve `<rtk>` prefix for grep/read on the pack file