TASK GUIDE · SOURCE-AWARE
Agent Skills for debugging and bug reproduction
A disciplined Skill plan for repository intake, minimal reproduction, and regression evidence.
Build this plan for my Agent ↗Observe first; change one variable at a time and preserve the original failure evidence.
01 · SKILL STACK
A minimal three-role stack
Each role has one job. The personalized builder can adjust the selection for your Agent without changing the decision logic.
Repo Intake and Plan
Maps the relevant execution path before changing code.
- Main limitation
- Detailed package files are not fully catalogued.
- First risk
- Review before install
- Source evidence
- Pinned · fb3ccdf5
grill-me
Forces a minimal run and challenges unsupported assumptions.
- Main limitation
- The package is a launcher that calls the separate grilling Skill; installing grill-me alone may not include the interview itself.
- First risk
- Decision fatigue
- Source evidence
- Pinned · c55ee460
tdd
Turns the reproduced failure into a lasting regression check.
- Main limitation
- The workflow needs a functioning test runner and clear public behavior.
- First risk
- False confidence
- Source evidence
- Pinned · c55ee460
02 · ACCEPTANCE
How to know the task is finished
- Reproduce the same failure twice from a documented starting state.
- Identify the smallest input or state transition that triggers it.
- Add a check that fails before the fix and passes after it.
03 · STOP CONDITIONS
When to stop
- The reproduction depends on unknown external state.
- Multiple variables are changed before the failure is isolated.
- Logs may contain secrets or personal data.
04 · METHOD
How this guide was produced
SkillSignal maps a defined task to three non-overlapping responsibilities, then selects from reviewed catalog metadata. Agent fit, source state, permissions, and published scores are evaluated with deterministic rules. No LLM writes or reorders the recommendation at request time.