why

Investigate design rationale behind code by querying git history and MCP evidence sources.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/rockcookies/skills --skill why-rockcookies
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: why
Source: https://github.com/rockcookies/skills/tree/main/skills/cursor-plugins/why
Command: npx skills add https://github.com/rockcookies/skills --skill why-rockcookies

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code rarely explains why it exists. This Skill answers "why does X work this way" questions by investigating the historical record—commits, PRs, tickets, docs, chat, telemetry, and error tracking—instead of guessing from the code itself. ## Core Features & Use Cases - Parallel Evidence Investigation: Spawns one investigator subagent per available evidence category (source control, issue tracker, docs, chat, observability, error tracking, analytics warehouse), each following a source-specific playbook. - Confidence-Tiered Synthesis: A synthesizer subagent classifies every claim as Direct, Supported, Inferred, Speculative, or Unknown, with citations and an explicit "What We Don't Know" section. - Use Case: Ask "why is this API response clamped to 100 items?" and receive a cited answer tracing the threshold to a PR discussion, a linked ticket, and a Datadog monitor—plus honest gaps where evidence is missing. ## Quick Start Ask why the retry logic in src/payments/client.ts exists and have the skill investigate the code's history and all connected evidence sources.

Frequently Asked Questions about why

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find out why a piece of code was written a certain way?▼

Ask a why question about the target code and the skill anchors the investigation with git blame and log, then spawns parallel investigators across available evidence sources. A synthesizer returns a cited, confidence-tiered answer covering findings, inferences, and gaps.

What is the difference between the why and how skills?▼

The how skill explains what code does and how it works at runtime. The why skill explains the forces that led to its shape, using historical evidence from commits, PRs, tickets, docs, chat, and telemetry rather than code mechanics.

Which MCP servers does the why skill need to work?▼

Only git and the GitHub CLI are required, since source control is always available. Other categories like Linear, Notion, Slack, Datadog, Sentry, and Databricks are used when their MCPs are present, and missing ones are documented as gaps.

Can the why skill investigate code without any ticket or doc history?▼

Yes, it falls back on git history, PR discussions, code comments, and tests, which are always searchable. When other sources are unavailable, it explicitly reports them as gaps instead of fabricating rationale.

Why does the why skill report confidence tiers instead of one answer?▼

Historical evidence is fragmentary and sometimes contradictory, so each claim is tiered as Direct, Supported, Inferred, Speculative, or Unknown. This prevents confident-sounding guesses and tells you exactly what is cited versus inferred.