JPeetz/agent-skills / skills/development/nodejs-development
nodejs-development
VerifiedUse when building, debugging, or optimizing Node.js applications — Fastify servers, TypeScript with type stripping, Node.js core internals, OAuth 2.0/2.1 auth flows, TypeScript types, or diagnosing performance/crash issues. Covers the full Node.js stack from framework patterns (Fastify plugins, routes, schemas, hooks) through internals (V8, libuv, N-API, C++ addons) to production concerns (graceful shutdown, caching, streams, testing, error handling).
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 2.7 KB |
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 29.3 KB |
| evals/evals.json | config | 8.6 KB |
| references/improvement-report.md | markdown | 3.2 KB |
| references/security-scan-notes.md | markdown | 872 B |
| references/source-repo-reference.md | markdown | 2.8 KB |
references/improvement-report.md
View on GitHub# Improvement Report: What Changed from Source
This document records the improvements applied to each source skill during packaging.
## Overall Improvements (All Sections)
### 1. Consolidation
- **Before:** 5 separate skills with 50+ rule files spread across independent directories
- **After:** Single cohesive SKILL.md with cross-referenced sections
### 2. Cross-Linking
- **Before:** Each skill was independent with no cross-references
- **After:** Sections reference each other (e.g., A5 graceful shutdown references B10 Fastify integration; D2 JWT validation uses B5 authentication patterns)
### 3. Condensation
- **Before:** 50+ rule files (each 100-600 lines) with repeated metadata and frontmatter
- **After:** Single 30,000-character document with deduplicated patterns and shared code examples
### 4. Verifiability Added
- **Before:** No test cases, no verification checklists
- **After:** Dedicated [Verification](#verification) section with table of checks per section, plus 15 eval test cases
### 5. Pitfalls Section
- **Before:** Pitfalls scattered across individual rule files with no unified reference
- **After:** Single [Pitfalls](#pitfalls) section covering all 10 critical gotchas
### 6. Trigger Table
- **Before:** Each skill had its own "when to use" section
- **After:** Unified trigger table mapping signals to sections
## Section-by-Section Improvements
### §A Node.js Best Practices — from `node` skill
- Added `AbortController` example for cancellable async operations (not in source)
- Added explicit `env()` validation function pattern (not in source — source only referenced `@fastify/env`)
- Added explicit "operational vs programmer errors" classifier (source had it in a rule file; elevated to main body)
- Condensed flaky test diagnosis from 439-line rule file to concise checklist
- Added `Promise.allSettled()` recommendation (not explicitly called out in source)
### §B Fastify — from `fastify` skill
- Added `@fastify/helmet` reference (source omitted it in main SKILL.md, only in rule file)
- Added route-scoping example alongside global hooks (source separated them)
- Condensed 19 rule files into 10 concise subsections
- Created single unified lifecycle recommendations table
### §C Node.js Core Internals — from `nodejs-core` skill
- Simplified V8 GC description from academic detail to actionable developer knowledge
- Added explicit "timer phase vs check phase" comparison with `setImmediate` vs `setTimeout(cb, 0)` priority rule
- Condensed 21+ rule files into 4 subsections
- Added segfault decision tree (source had it split across multiple rule files)
### §D OAuth 2.0/2.1 — from `oauth` skill
- Added structured security checklist table (source had it as a markdown table; kept but reformatted)
- Added anti-patterns section with clear "do this instead" guidance
- Consolidated separate reference files (DEVICE_FLOW.md, TOKEN_VALIDATION.md, CLIENT_CREDENTIALS.md, MOBILE_OAUTH.md) into a single security section
### §E Advanced TypeScript — from `typescript-magician` skill
- Added `Unwrap<T>` conditional type example (not in source)
- Added `DeepPartial<T>` example (not in source)
- Added explicit type workflow (tsc --noEmit → identify → craft → validate → re-check)
- Condensed 14 rule files into 6 concise subsections
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |