grounding-before-coding — Claude Code skill: inspect code and data
The grounding-before-coding skill makes the agent inspect code and data before changing a project or explaining a bug. It fits unfamiliar repositories and non-trivial work.
no license 25,600 installs ★ 6 updated 2026-09-11
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a claude-codeWhat grounding-before-coding does
grounding-before-coding sets a research step before implementation. The agent traces actual entry points, reads the code behind names, checks the relevant data, and supports important claims with file:line, query results, or command output. For a bug, it must observe the failure before changing the code and inspect every route into a shared area.
The skill also records invariants, existing guards, and repository conventions that a change must preserve. It covers investigations where no edit is planned yet. The required background is the principal-engineering skill, so that dependency belongs in the setup plan.
What it helps with
- understand an unfamiliar repository
- reproduce a bug before editing code
- trace every caller of shared logic
- support conclusions with code evidence
- record invariants before a change
Example prompts for the agent
- Before changing anything, inspect the project tree and support each key finding with a
file:linereference. - Investigate why an export is sometimes empty: reproduce the failure first, then trace the code and data.
- Find every route into this shared code and list the invariants the fix must preserve.
How to install grounding-before-coding
1Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a claude-code2Manually: put the files in place
~/.claude/skills/grounding-before-coding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grounding-before-coding/
1Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a codex2Manually: put the files in place
.agents/skills/grounding-before-coding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a cursor2Manually: put the files in place
.cursor/skills/grounding-before-coding/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install riekelt/principal-engineer plugins/principal-engineer/skills/grounding-before-coding2Manually: put the files in place
.github/skills/grounding-before-coding/SKILL.md1Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a gemini-cli2Platform CLI
gemini skills install https://github.com/riekelt/principal-engineer --path plugins/principal-engineer/skills/grounding-before-codingManually: put the files in place
.devin/skills/grounding-before-coding/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill grounding-before-coding -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about grounding-before-coding
How do I install grounding-before-coding in Claude Code?
Run npx skills add riekelt/principal-engineer --skill grounding-before-coding -a claude-code, then check ~/.claude/skills/grounding-before-coding/SKILL.md.
What does grounding-before-coding do?
It makes the agent inspect code and data before a change or conclusion, support key claims with evidence, and reproduce failures before fixes.
What does grounding-before-coding require?
The skill requires principal-engineering as background.