Agent skill
cursor-explorer-mcp
Use for token-expensive operations requiring multi-file analysis - codebase exploration, broad searches, architecture understanding, tracing flows, finding implementations across files. Uses MCP cursor-agent server (company pays) with clean async interface. Do NOT use for single-file analysis, explaining code already in immediate context, or pure reasoning tasks.
Install this agent skill to your Project
npx add-skill https://github.com/sepiabrown/.claude/tree/main/skills/cursor-explorer
SKILL.md
Cursor Explorer (MCP)
Trigger immediately when you see:
- "Find where X is..." → cursor-agent
- "How does X work?" (multi-file) → cursor-agent
- "Trace the flow of..." → cursor-agent
- Manual approach needs 3+ file reads → cursor-agent
Skip for: single file, pure reasoning, code in context, 1-2 line answers
Workflow
# 1. Start query (batch multiple questions)
start = mcp__cursor_agent__cursor_agent_start({
"query": "Find where X is. Give file:line, code snippets, purpose."
})
query_id = json.loads(start)["query_id"]
# 2. Get result (blocks until done)
result = mcp__cursor_agent__cursor_agent_result({
"query_id": query_id,
"wait": True # Blocks automatically, no manual monitoring needed
})
output = json.loads(result)
# 3. If completed, present findings. If failed, fall back to Read/Grep.
Never retry on failure - just fall back to manual tools.
Query Tips
- Request file:line refs
- Ask for code snippets
- Batch related questions
- Be specific about format needed
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
Didn't find tool you were looking for?