CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

runtime-debug

Debug and verification workflow for runtime-bundle and module-resolution regressions. Use when diagnosing unexpected module inclusions, bundle size regressions, or CI failures related to NEXT_SKIP_ISOLATE, nft.json traces, or runtime bundle selection (module.compiled.js). Covers CI env mirroring, full stack traces via __NEXT_SHOW_IGNORE_LISTED, route trace inspection, and webpack stats diffing.

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

86%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.

A tight, high-signal debugging skill: it captures non-obvious env flags, file paths, and a webpack stats technique that Claude could not reconstruct on its own, with no padding. The main improvement opportunity is making the route-trace/chunk inspection steps as executable as the rest (e.g., an example grep/jq over nft.json or a skeleton test-start-webpack assertion).

DimensionReasoningScore

Conciseness

Lean and efficient throughout: every section delivers non-obvious information only (env var values and their effects, the exact source file 'packages/next/src/server/patch-error-inspect.ts', a minimal next.config.js snippet, a specific stats.toJson call). Nothing explains concepts Claude already knows; the one explanatory sentence about ignore-listed frames describes non-obvious framework behavior that earns its place. Not verbose in any section, so above the anchor-4 'minor trimming' case.

5 / 5

Actionability

Mostly executable: exact flags ('IS_WEBPACK_TEST=1', 'NEXT_SKIP_ISOLATE=1', '__NEXT_SHOW_IGNORE_LISTED=true'), a copy-paste next.config.js block, concrete artifact paths ('.next/server/.../page.js.nft.json', 'next/dist/server/stream-utils/node-stream-helpers.js'), and a precise stats.toJson invocation. Not a 5 because steps 1-2 of the guardrail ('inspect route trace artifacts', 'inspect traced server chunks for forbidden internals') and the assertion in step 3 are described but give no example command or test snippet to copy.

4 / 5

Workflow Clarity

The guardrail workflow is a clear numbered 1-2-3 sequence ending in a validation step ('fails on forbidden internals'), and the repro section includes an explicit re-validation check ('always rerun without NEXT_SKIP_ISOLATE=1'). Not a 5 because the skill is a set of parallel debugging techniques rather than one end-to-end sequence, and the webpack stats diffing section gives the what but no explicit ordered steps or diff-interpretation checkpoint.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the body is under 50 lines with clean, well-labeled sections each covering one technique — the simple-skill case where well-organized sections alone warrant a 5. The 'Related Skills' section is a single-level, clearly signaled pointer list ($flags, $dce-edge, $react-vendoring) with no nested references, so navigation is trivial and nothing that belongs in a separate file is inlined.

5 / 5

Total

18

/

20

Passed

Description

87%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: it names a precise niche, gives an explicit 'Use when...' trigger clause with concrete artifacts, and lists specific capabilities with real identifiers. Third-person voice and tight length are both appropriate. The only soft spot is that capability coverage is expressed as a 'Covers...' list rather than exhaustive concrete actions.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — 'CI env mirroring, full stack traces via __NEXT_SHOW_IGNORE_LISTED, route trace inspection, and webpack stats diffing' — plus concrete diagnostics targets ('unexpected module inclusions, bundle size regressions, CI failures'). Sits between anchor 4 and 5: coverage is strong but phrased as a 'Covers...' capability list rather than fully comprehensive discrete actions, and some gaps remain (e.g., how stats diffing is performed).

4 / 5

Completeness

Explicitly answers both: 'what' is 'Debug and verification workflow for runtime-bundle and module-resolution regressions' and 'when' is a concrete 'Use when diagnosing unexpected module inclusions, bundle size regressions, or CI failures related to...' clause with specific trigger artifacts. Matches the anchor-5 example structure (what + 'Use when' with concrete triggers).

5 / 5

Trigger Term Quality

Good keyword coverage with the exact identifiers an affected engineer would say: 'NEXT_SKIP_ISOLATE', 'nft.json traces', 'module.compiled.js', 'bundle size regressions', 'CI failures'. Not a 5 because a few natural phrasings users might use ('node internals leaking into the client bundle', 'server chunks') are absent, though for an internal skill the technical triggers are the natural terms.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Next.js runtime-bundle/module-resolution regressions) with highly distinct triggers like 'NEXT_SKIP_ISOLATE', 'nft.json', and 'module.compiled.js' that virtually no other skill would claim. Minimal conflict risk with generic debug/build skills because the specific env vars and trace filenames disambiguate.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

vercel/next.js

Path

.agents/skills/runtime-debug/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.