how — Claude Code skill: what it does, how to install
Explores codebase architecture and runtime execution paths before you edit code. Helps determine module ownership, layering, and placement for new features.
npx skills add cursor/plugins --skill how -a claude-codeWhat how does
The skill inspects codebases to answer architectural and operational questions. It produces a walkthrough suited for an onboarding engineer without turning into an annotated line-by-line code dump. For understanding the historical rationale behind decisions, the documentation recommends using the why skill instead.
Execution depends on complexity. Narrow questions run through a single explainer subagent. Broader cross-cutting features get split into two to four distinct angles, handing exploration to parallel Task subagents before synthesizing findings into standard sections: Overview, Key Concepts, How It Works, Where Things Live, and Gotchas.
Every spawned subagent runs with readonly: true, keeping repository files untouched during codebase exploration. Model assignments pull from the pstack-models.mdc rule, defaulting to grok-4.7-xhigh-fast for exploration and claude-opus-5-5-xhigh for explanation.
What it helps with
- build a mental model of an unfamiliar subsystem
- decide which package or layer should own new logic
- trace cross-service execution flow before refactoring
- identify architectural gotchas across complex code paths
Example prompts for the agent
- How does the authentication subsystem work across modules?
- Which package owns webhook validation, and is this the right layer?
- Walk me through the billing subsystem architecture before I change it.
How to install how
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill how -a claude-code2Manually: put the files in place
~/.claude/skills/how/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/how/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill how -a codex2Manually: put the files in place
.agents/skills/how/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill how -a cursor2Manually: put the files in place
.cursor/skills/how/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cursor/plugins how2Manually: put the files in place
.github/skills/how/SKILL.md1Skills CLI (Vercel)
npx skills add cursor/plugins --skill how -a gemini-cli2Platform CLI
gemini skills install https://github.com/cursor/plugins --path pstack/skills/howManually: put the files in place
.devin/skills/how/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cursor/plugins --skill how -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set18
The whole set →Similar
Questions about how
How to install how in Claude Code?
Run npx skills add cursor/plugins --skill how -a claude-code in your terminal.
What does the how skill do?
It investigates code repositories using Task subagents to produce architectural walkthroughs, component ownership maps, and subsystem overviews.
Which models does how use for subagents?
It reads definitions from the pstack-models.mdc rule. Defaults are grok-4.7-xhigh-fast for explorer subagents and claude-opus-5-5-xhigh for the explainer.