Individual skill
why
Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.
skills/why/SKILL.md
Source commit 6c75f4e67546c2ddbf9634734c1e3ebbea34861a
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 3, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 3,769
- Repository last updated
- Nov 6, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agentskills Repository topic
- pstack Repository topic
- pstack-claude Repository topic
- skills Repository topic
- backnotprop Repository topic
- agent-skills Repository topic
- ai-agents Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- codex Repository topic
- data Derived category
- design Derived category
- devops Derived category
- docs Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 9,678 bytesSKILL.mdcore · 9,678 bytesSKILL.mdcore · 9,678 bytesSKILL.mdcore · 9,678 bytesreferences/epistemics.mddoc · 6,736 bytesreferences/investigator-prompt.mddoc · 5,554 bytesreferences/source-playbook.mddoc · 1,363 bytesreferences/sources/code-archaeology.mddoc · 1,440 bytesreferences/sources/databricks.mddoc · 6,994 bytesreferences/sources/datadog.mddoc · 4,971 bytesreferences/sources/incident-postmortem.mddoc · 372 bytesreferences/sources/linear.mddoc · 2,996 bytesreferences/sources/notion.mddoc · 2,853 bytesreferences/sources/sentry.mddoc · 2,089 bytesreferences/sources/slack.mddoc · 1,336 bytesreferences/synthesizer-prompt.mddoc · 7,146 bytes
Read excerpt
# Why
Investigate the motivation and intent behind code. The companion `how` skill answers what the code does and how it works. `why` answers what forces led to its shape.
Each spawn below names a role line in the pstack settings file (`~/.cursor/rules/pstack-models.mdc` in Cursor, `~/.claude/rules/pstack-models.md` in Claude Code, `~/.agents/pstack-models.md` in other harnesses) and a default. Set `model` to that line's value, or to the default if the file or the line is missing. Leave `model` unset when the value is `auto` or `inherit-parent`. If your subagent tool rejects a slug, use the default and say so. If it rejects the default, use the closest valid slug of the same family from its error message or your harness's model list. Pick each subagent's reasoning level and fast or standard speed for the job, per the Subagents section of the **poteto-mode** skill.
Every spawn is `generalPurpose` with `readonly: false` (agent mode). **Do not use readonly/Ask mode.** It strips MCP access, which disables the MCP-backed investigators and the synthesizer's citation spot-checks. Investigators still shouldn't write anything.
## Operating Posture
Operate as a **careful, cautious, and precise investigator**. Be honest about what you know vs what you're inferring. Read `references/epistemics.md` for the full confidence framework and phrasing guide. The synthesizer must follow it.
## Step 1. Understand the Target and the Question