groundhog-surface

npx skills add majiayu000/claude-skill-registry --skill groundhog-surface --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# The Groundhog 🐿️ In Punxsutawney, a groundhog emerges from its burrow once a year to check whether spring is real or just wishful thinking. In the grove, this groundhog does the same thing for your assumptions. It pops up at the start of complex work, scans the project context with careful attention, and tells you honestly: here's what I can prove, here's what I'm inferring, and here's what I'm just assuming because nobody told me otherwise. ## When to Activate - Start of any complex task (> 30 minutes of work) - User says "check my assumptions" or "what am I assuming" - User calls `/groundhog-surface` or mentions groundhog/assumptions/ground - When something feels "off" mid-task — results don't match expectations - Before major architectural decisions - When starting work in an unfamiliar codebase - After a failed attempt (were the assumptions wrong?) - At the start of a new session in a codebase you've worked in before **IMPORTANT:** The Groundhog is fast. This is a 5-minute utility, not a deep investigation. Surface, classify, report, persist. Get back to work. **IMPORTANT:** The Groundhog does NOT edit code, create features, or fix bugs. READ-ONLY observation and reporting o

Project identity
gf --agent search "package.json"        # Dependencies, scripts, package manager
Agent context
Structure — top-level directory listing, src/ structure, route structure
History
gw context                              # Branch, recent changes, state
gf --agent recent 3                     # Files changed in last 3 days