Skip to content

JPeetz/agent-skills / skills/development/nodejs-development

nodejs-development

Verified

Use 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).

FileKindSize
CHANGELOG.mdmarkdown2.7 KB
LICENSEother1.0 KB
SKILL.mdskill md29.3 KB
evals/evals.jsonconfig8.6 KB
references/improvement-report.mdmarkdown3.2 KB
references/security-scan-notes.mdmarkdown872 B
references/source-repo-reference.mdmarkdown2.8 KB

CHANGELOG.md

View on GitHub
# Changelog

All notable changes to this skill package are documented here.

## [1.0.0] — 2025-09-07

### Added

- **Initial release** — Comprehensive Node.js Development meta-skill packaging 5 core skillsets from [mcollina/skills](https://github.com/mcollina/skills) by Matteo Collina.

### Sections included

- **Section A: Node.js Best Practices** — Type stripping (Node 22.6+), error handling (`@fastify/create-error`, operational vs programmer), streams (`pipeline()` + async generators), caching (`lru-cache`, `async-cache-dedupe`), graceful shutdown (`close-with-grace`), testing (`node:test` + `inject()`), flaky test diagnosis, stuck process diagnosis, async patterns (`AbortController`, `Promise.allSettled`), profiling (`--cpu-prof`, `--trace-opt`), environment configuration.
- **Section B: Fastify Application Architecture** — Plugin system & encapsulation, TypeBox schema validation, request lifecycle (hooks), authentication (`@fastify/jwt`), testing (`inject()`), logging (Pino), CORS/security, error handling, full lifecycle reading recommendations.
- **Section C: Node.js Core Internals** — V8 GC (Scavenger, Mark-Sweep, Mark-Compact), hidden classes & inline caching, TurboFan JIT & deoptimization, libuv event loop phases & thread pool, N-API & node-addon-api C++ addons, segfault decision tree, Node.js core contribution rules.
- **Section D: OAuth 2.0/2.1 with Fastify** — Authorization Code + PKCE, JWT validation middleware, refresh token rotation, security checklist, anti-patterns.
- **Section E: Advanced TypeScript Types** — Eliminating `any`, conditional types & `infer`, template literal types, mapped types, branded/opaque types, type workflow.

### Source skills adapted

| Source Skill | Source Author | Coverage |
|-------------|--------------|----------|
| node | Matteo Collina | §A except node-modules-exploration, modules (covered by TypeScript section) |
| fastify | Matteo Collina | §B (all 19 rule files condensed) |
| nodejs-core | Matteo Collina | §C (all domains, condensed) |
| oauth | Matteo Collina | §D (all flows condensed with security checklist) |
| typescript-magician | Matteo Collina | §E (core patterns condensed) |

### Not included (already covered in JPeetz/agent-skills or universal)

| Source Skill | Reason for Exclusion |
|--------------|---------------------|
| documentation | Already handled by JPeetz/agent-skills documentation-content category |
| init (AGENTS.md) | Already handled by JPeetz/agent-skills skill-development category |
| linting-neostandard-eslint9 | General tooling, not Node.js-specific |
| octocat | Already handled by JPeetz/agent-skills git-release category |
| skill-optimizer | General skill optimization, not Node.js-specific |
| snipgrapher | Code snippet rendering, not Node.js-specific |
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall