CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

what-happened

Explain why code looks the way it does by tracing the latest change for a file range or pasted snippet through `git blame` and deduplicated `entire explain` lookups. Use when the user asks what happened, says "tell me why" about a code block, is confused about a section of code, asks "wtf is going on", "why is this like this", "why was this changed", or wants provenance for a specific file block.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers an exceptionally actionable, well-sequenced workflow with explicit validation gates and a complete failure-state taxonomy, and the response format is fully specified. Its main weakness is token efficiency: the header rule and deduplication guidance are repeated across multiple sections and could be consolidated, and some template material could move to a reference file.

Suggestions

Consolidate the 'Entire What Happened:' header rules into the Response format section and reference it once from the other steps instead of restating the prohibition at each stop point.

Merge the deduplication guidance from Rule 6 into Step 3 (or vice versa) so commit/checkpoint dedup is specified in exactly one place.

Consider moving the trigger-phrase catalog and/or the seven-variant response template into a references/ file so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The body is operational rather than tutorial (it does not explain git blame or basic concepts), but it includes avoidable repetition: the 'Do not use the `Entire What Happened:` header' rule is stated eight or more times across Rules, Workflow steps 1-2, and the >5-commits gate, and the deduplication rules appear in both Rule 6 and Step 3. It sits between anchor 4 (minor trimming needed) and anchor 2 (several padded sections): mostly efficient with a real, fixable redundancy pattern.

3 / 5

Actionability

Every step has exact, executable commands — `git blame --porcelain -L <start>,<end> -- "<path>"`, `entire explain --commit <commit-sha> --no-pager`, `grep -n -F -- "<distinctive snippet line>" "<path>"` — plus a complete copy-paste-ready response template with every status variant and exact fallback phrasing. This matches the anchor-5 example of fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The four-step workflow (resolve target → gather provenance → explain each unique commit → fallback analysis) is clearly sequenced with explicit validation: exact-line resolution is required before any blame, unfound or ambiguous snippets stop with user feedback, and the >5-unique-commits gate asks the user to narrow. Rule 7's enumerated seven-state checklist functions as an explicit error-recovery map for every failure mode. This matches anchor 5's validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The single file is well organized with clear sections (Goal, Rules, Workflow, Response format, Trigger phrases) and no buried or nested references — but no bundle files exist, and at ~324 lines the trigger-phrase catalog and the long seven-variant response template are candidates to split into a reference file to keep SKILL.md lean. Good structure with minor organization gaps matches anchor 4; it does not qualify for the small-skill exception to reach 5.

4 / 5

Total

17

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly and concretely states both what the skill does and when to use it, with an excellent breadth of natural trigger phrases. Its only weakness is minor overlap risk with general code-explanation skills and slight under-coverage of the skill's fallback-analysis capability.

DimensionReasoningScore

Specificity

The description names concrete actions — 'tracing the latest change for a file range or pasted snippet through `git blame` and deduplicated `entire explain` lookups' — with specific input formats (file range, pasted snippet). It falls between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive multi-action coverage): it lists several specific actions but omits capabilities present in the body such as fallback code-behavior analysis and per-block snippets.

4 / 5

Completeness

It explicitly answers both 'what' ('Explain why code looks the way it does by tracing the latest change... through `git blame` and deduplicated `entire explain` lookups') and 'when' ('Use when the user asks what happened, says "tell me why" about a code block...') with concrete trigger phrases, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

The description covers comprehensive natural trigger phrases: 'what happened', 'tell me why', 'wtf is going on', 'why is this like this', 'why was this changed', 'confused about a section of code', and 'provenance for a specific file block'. This matches the anchor-5 example's breadth of natural synonyms rather than leaving common variations missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — latest-change provenance on a specific file block via git blame and `entire explain` — with distinct trigger phrasing. However, questions like 'why does this exist' or 'help me understand this block' overlap with general code-explanation skills (the body itself notes the separate `explain` skill), so minor overlap risk with a closely related skill keeps it at anchor 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

SnowingFox/ai-skills

Path

.agents/skills/what-happened/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.