Catalog
Yeachan-Heo/blast-radius

Yeachan-Heo

blast-radius

Map what a change could break beyond the diff — dependents found by search and AST, classified certain/likely/unlikely — and prove the certain and likely ones by running their checks. Before risky refactors or signature changes.

v1.0LATEST
NewUpdated Nov 8, 2026

Blast Radius

The diff tells you what changed; it does not tell you what breaks. This skill maps the dependents of a change and proves what it can — by running code, not by reasoning alone.

When to use

  • a signature, data shape, or behavior other code calls changed
  • a dependency bump, config default flip, or migration
  • the user asks "what could this break?"

Workflow

  1. Name the change surface: exported symbols, persisted formats, CLI flags, API contracts, timing assumptions. List them explicitly.
  2. Map dependents: grep for each symbol; where available use AST search (ast_grep_search MCP tool) to catch structural uses text search misses; follow re-exports one more hop than feels necessary.
  3. Classify each dependent:
    • certain — calls the changed surface directly
    • likely — consumes a type or format the change touches
    • unlikely — shares a module but not the surface
  4. Prove what you can: for every certain and likely impact, run the exact check that would catch the break — its test, its typecheck, its build, or a one-off command exercising the path. Report real output. Impacts you cannot execute a check for are listed as unverified, not as safe.
  5. Report: the surface, the dependent counts by class, per-impact verification with evidence, and the unverified remainder named honestly.

Rules

  • "It should be fine" is not a classification; every claim is certain, likely, unlikely, or unverified, with its reason in the same sentence.
  • Reasoning reduces the search space; execution settles the verdict.
  • The report never edits code; fixes found this way go through execute.
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

88

Quality

79

Clarity

84

Completeness

78

Summary

The blast-radius skill guides an agent through impact analysis of code changes by identifying dependents through search (grep, AST), classifying them by likelihood of breakage (certain/likely/unlikely), and proving impacts by running checks (tests, typecheck, build). The skill emphasizes execution-based verification over reasoning, producing a structured report with evidence for each classified impact.

Detected Capabilities

search execution (grep, AST-based)code analysis and symbol mappingbuild/test executiontypecheck executionstructured report generationMCP tool integration (ast_grep_search)

Trigger Keywords

Phrases that agents use to match this skill to user intent.

assess impact of changemap code dependentsfind what breaksrefactor safelyverify signature changecheck blast radius

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.com

Use Cases

  • Assess blast radius of signature changes before refactoring
  • Map dependents affected by a dependency upgrade
  • Validate API contract changes across consumers
  • Determine scope and risk of configuration default flips
  • Prove which code paths break after a data shape change

Quality Notes

  • Skill provides a clear, disciplined methodology: name surface → map dependents → classify → verify → report
  • Strong emphasis on execution-based evidence over speculation ('reasoning reduces the search space; execution settles the verdict')
  • Explicit classification system (certain/likely/unlikely/unverified) prevents hand-wavy claims and forces precision
  • Workflow is self-contained and actionable — an agent has enough guidance to execute each step
  • References real tool ecosystem (ast_grep_search MCP, tests, typecheck, build commands) without prescribing implementation
  • Does not modify code — skill is read-only analysis plus execution of external checks
  • Minor: workflow assumes familiarity with identifying 'changed surface' — could benefit from a concrete example (e.g., 'if you changed a function signature, the surface is the parameters and return type')
  • Minor: workflow does not address circular or transitive dependencies explicitly (though 're-exports one more hop' hints at it)
Model: claude-haiku-4-5-20251001Analyzed: Nov 8, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use Yeachan-Heo/blast-radius in your dev environment

Command Palette

Search for a command to run...