Skip to content

chore(skills): replace 15 tier skills with single /explore-codebase#230

Merged
HumanBean17 merged 1 commit into
masterfrom
chore/skills-single-explore-codebase
May 25, 2026
Merged

chore(skills): replace 15 tier skills with single /explore-codebase#230
HumanBean17 merged 1 commit into
masterfrom
chore/skills-single-explore-codebase

Conversation

@HumanBean17
Copy link
Copy Markdown
Owner

Summary

  • Replaces 15 narrow per-intent skills (11 tier-1 + 4 tier-2) with a single comprehensive /explore-codebase skill containing the complete MCP operating manual
  • Empirical testing showed agents perform better with one full-context skill than with sliced subsets — the agent retains the decision tree, edge taxonomy, and recovery playbook rather than operating from a narrow slice
  • Updates validator, AGENTS.md, README.md, and paper.tex to reflect the new structure

Changes

  • New: skills/explore-codebase/SKILL.md — standalone skill with full edge taxonomy, NodeFilter reference, decision tree, argument shapes, recovery playbook, navigation patterns, and worked example
  • Removed: skills/tier-1/ (11 skills) and skills/tier-2/ (4 skills)
  • Updated: skills/README.md, tests/test_agent_skills_static.py, AGENTS.md, README.md, docs/paper/paper.tex

Test plan

  • .venv/bin/python -m pytest tests/test_agent_skills_static.py -v — 19 passed
  • .venv/bin/python -m pytest tests -v — 572 passed, 9 skipped
  • Manual: load /explore-codebase in Claude Code and verify agent navigates a codebase correctly

🤖 Generated with Claude Code

…odebase

Empirical testing showed agents perform better with one comprehensive
skill than with 15 narrow per-intent skills — the full decision tree,
edge taxonomy, and recovery context in one prompt outperforms sliced
subsets. Replace all tier-1 and tier-2 skills with a single standalone
/explore-codebase skill containing the complete MCP operating manual.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@HumanBean17 HumanBean17 force-pushed the chore/skills-single-explore-codebase branch from 942a6bd to 8e1c115 Compare May 25, 2026 18:52
@HumanBean17 HumanBean17 merged commit 0a3e98a into master May 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant