feat: add ts-node-debugger skill for the codebase-aware TypeScript/Node.js debugging

[KrishnaMuddi]

ts-node-debugger

Codebase-aware TypeScript/Node.js debugging skill. On first use per repo,
the agent reads key project files and generates .claude/project-context.md.
Commit that file once — every teammate gets project-aware debugging from
their next git pull, no per-developer setup needed.

Category

💻 Coding & Engineering

Codebase aware skill where Fixes match the project's actual patterns - if the codebase uses Result<T>, fixes use Result<T>. If it uses throws, fixes use throws. File and line references come from files the LLM actually read, never invented.

What it covers

• TS compiler errors (TS2xxx codes)
• Runtime crashes and null/undefined errors
• Async/Promise bugs and unhandled rejections
• Type narrowing and union type failures
• Test failures - Jest, Vitest, Playwright, Testing Library
• Env/config bugs - "works locally, fails in CI/Lambda/prod"
• ESM/CJS and module resolution errors

Token efficiency

Only SKILL.md is always in context.
Three reference files loaded on demand:

• references/discovery.md - first run per repo only
• references/env-checklist.md - env/config bugs only
• references/patterns.md - when writing fixes

Demo video link

https://drive.google.com/file/d/1Yp3sFRq714h2ErVI0_zcwT2q_T-7xW3g/view?usp=sharing

[github-actions]

Skill Evaluator — Tier 1 Results

✅ All checks passed

skills/ts-node-debugger

Using CPython 3.11.15 interpreter at: /opt/hostedtoolcache/Python/3.11.15/x64/bin/python3
Creating virtual environment at: .venv
Downloading tiktoken (1.1MiB)
 Downloaded tiktoken
Installed 8 packages in 14ms
=== Skill Evaluation Report ===
Skill: ts-node-debugger

--- Tier 1: Deterministic Checks ---
[PASS] SKILL.md exists
[PASS] kebab-case directory
[PASS] YAML frontmatter
[PASS] metadata.json
[PASS] length/efficiency — 883 tokens. Instruction/code ratio: 17.2.
[PASS] prerequisites — No heavy external prerequisites detected.
[PASS] security patterns — No security section found.

--- Summary ---
Tier 1: 7/7 passed