Scope

---
name: scope
description: >
  This skill should be used when the user types "/scope", "/scope list",
  "/scope clear", "/scope save ...", or "/scope load ...". It exposes Retriever's
  visible slash-command surface for inspecting and managing the active scope.
metadata:
  version: "1.1.17"
---

> Operates under `retriever:routing`. If the user's intent actually fits a different tier — another `retriever:*` skill, a Tier 2 slash, a Tier 3 `tools.py` subcommand, or (last resort) direct DB access — stop and re-route against the ladder before continuing.

# Retriever /scope

Use this skill for `/scope`, `/scope list`, `/scope clear`, `/scope save <name>`, and `/scope load <name>`.

## Read-only fast path

For the exact read-only forms `/scope` and `/scope list`:

- Do not read [../search/SKILL.md](../search/SKILL.md).
- Run exactly one Bash command from the workspace root:
  - `/scope`: `python3 skills/tool-template/tools.py slash . /scope`
  - `/scope list`: `python3 skills/tool-template/tools.py slash . /scope list`
- If canonical tool auto-discovery fails, retry once with `RETRIEVER_CANONICAL_TOOL_PATH` pointed at [../tool-template/tools.py](../tool-template/tools.py).
- Return stdout exactly as the entire response. No preamble. No commentary. No reformatting.

## Other forms

For `/scope clear`, `/scope save <name>`, and `/scope load <name>`:

1. Read [../search/SKILL.md](../search/SKILL.md).
2. Treat this skill as the slash command `/scope`.
3. Return only the resulting Retriever state or table output. Do not add a preamble, trailing summary, or follow-up suggestion.