skills/scout/SKILL.md
Filesystem exploration with human-friendly eza tree views and git status; delegates content/code search to cheez-search (AST-aware via tilth). Use when the user says "search files", "find by metadata", "tree view", "list directory with git status", or invokes /scout. Do NOT use for symbol, usage, or structural code search — that's cheez-search.
npx skillsauth add paulnsorensen/dotfiles scoutInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Filesystem exploration skill. All code/content search is delegated to
easy-cheese:cheez-search (AST-aware tilth MCP). The only thing scout
itself owns is ls (eza) — directory listings with git status and tree views.
| Task | Tool |
|------|------|
| Find a definition / usage / caller | Skill(skill="easy-cheese:cheez-search", args="...") |
| Find files by name, extension, type | Skill(skill="easy-cheese:cheez-search", args="...") (with glob: filter) |
| Read a file you've located | Skill(skill="easy-cheese:cheez-read", args="...") |
| Tree view of a directory | ls -T -L 2 (eza) |
| Long listing with git status | ls -la --git (eza) |
Any time you would have reached for rg, fd, or grep, invoke
easy-cheese:cheez-search instead. It uses tilth MCP for tree-sitter
structural matching, finds definitions before usages, and returns ranked
results with inline source.
Skill(skill="easy-cheese:cheez-search", args="<symbol or text> [glob:*.ts]")
If mcp__tilth__* is unavailable (tilth MCP not loaded or daemon down),
cheez-search will hard-fail. Surface that error to the user — do not fall
back to raw rg/fd from this skill.
ls is aliased to eza — color-aware ls replacement with --git status
column and tree view (-T).
ls -T -L 2 # tree view, 2 levels deep
ls -T -L 3 --dirs-first # tree, dirs first, 3 levels
ls -la --git # long listing with git status
easy-cheese:cheez-writeeasy-cheese:cheez-readeasy-cheese:cheez-search/briesearcheza may not be available in sub-agent contexts — falls back to plain lstools
Reconstruct what a past coding-agent session was doing so you can resume it — goal, files touched, last verified state, and the next step — by querying the session logs. Use when the user says "what was I working on", "recover that session", "reconstruct where I left off", "resume my last session", "what did that session change", "rebuild context from logs", or invokes /work-recovery. Report-only — it never scores or judges. Do NOT use for usage scoring (that is /skill-improver, /tool-efficiency, /prompt-analytics) or one-off interactive log queries (that is /session-analytics).
development
Curate this repo's hallouminate wiki (.hallouminate/wiki/, the repo:dotfiles:wiki corpus) — add or update architecture pages, per-harness docs, and gotchas. Use when the user says "update the wiki", "document this in the wiki", "refresh the harness docs", "add a wiki page", "curate the wiki", "the wiki is stale", or invokes /wiki-curator. Also use at session end to write back a non-obvious decision or gotcha worth preserving. Grounds the existing wiki first, follows one-topic-per-file conventions, verifies every external doc URL before writing, and reindexes. Do NOT use for general code search (that is cheez-search) or for editing AGENTS.md command reference.
tools
Audit how a tool, command, or MCP server is actually used across coding-agent sessions and produce calibrated recommendations — tool-vs-task fit, error forensics, fix recommendations, permission friction, MCP health, and token economics. Use when the user says "tool efficiency", "am I using X efficiently", "audit tool usage", "why does X keep failing", "how do I fix this error", "what should I change", "permission friction", "is this MCP worth it", "tool error rate", "fix recommendations", or invokes /tool-efficiency. Do NOT use for auditing a skill or agent definition (that is /skill-improver) or for one-off interactive log queries (that is /session-analytics).
tools
Analyze how prompts and skill routing behave across coding-agent sessions and produce calibrated recommendations — prompt-pattern analysis, routing accuracy, and knowledge gaps. Use when the user says "analyze my prompts", "prompt patterns", "is routing working", "which skill should have fired", "knowledge gaps", "what do I keep asking", or invokes /prompt-analytics. Do NOT use for auditing a single skill/agent definition (that is /skill-improver), tool/MCP efficiency (that is /tool-efficiency), or one-off interactive log queries (that is /session-analytics).