# jasnell/node-skills architecture

> Architecture diagram of the GitHub repository jasnell/node-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jasnell/node-skills
- Repository: https://github.com/jasnell/node-skills

## Overview

node-skills is a library of focused Node.js agent skills, distributed for Claude Code and opencode. The main workflow is a developer asks a coding agent about a newer Node.js feature; the agent selects a relevant skill and uses its guidance and examples to help produce code. Skills span feature probing, migration, and individual API domains. A separate maintainer workflow surveys upstream changes and updates the skill set. The README documents these capabilities and installation routes; sampled source confirms installer behavior, but not runtime agent skill-selection internals.

Main entry points: [`.claude/skills/node-skills-maintainer/SKILL.md`](https://github.com/jasnell/node-skills/blob/main/.claude/skills/node-skills-maintainer/SKILL.md) (Maintainer guidance), [`install/install.mjs`](https://github.com/jasnell/node-skills/blob/main/install/install.mjs) (Installer), [`tools/survey.mjs`](https://github.com/jasnell/node-skills/blob/main/tools/survey.mjs) (Upstream survey), [`skills/node-experimental-check/SKILL.md`](https://github.com/jasnell/node-skills/blob/main/skills/node-experimental-check/SKILL.md) (Experimental check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_probe["Probe and migration"]
  node_probe_skill["Experimental check<br/>[SKILL.md]"]
  node_migration["Modern migration<br/>[SKILL.md]"]
end

subgraph group_apis["Node.js API skills"]
  node_modules["Module loading<br/>[SKILL.md]"]
  node_process["Process timeout<br/>[SKILL.md]"]
  node_bench["Benchmarking<br/>[SKILL.md]"]
  node_histogram["Histogram stats<br/>[SKILL.md]"]
  node_test["Test runner<br/>[SKILL.md]"]
  node_utilities["Utilities<br/>[SKILL.md]"]
  node_sqlite["SQLite<br/>[SKILL.md]"]
  node_zip["ZIP archives<br/>[SKILL.md]"]
  node_streams["Stream iteration<br/>[SKILL.md]"]
  node_crypto["Cryptography<br/>[SKILL.md]"]
  node_permissions["Permissions<br/>[SKILL.md]"]
  node_diagnostics["Diagnostics<br/>[SKILL.md]"]
  node_networking["Networking<br/>[SKILL.md]"]
  node_vfs["Virtual filesystem<br/>[SKILL.md]"]
  node_ffi["Foreign functions<br/>[SKILL.md]"]
  node_quic["QUIC and DTLS<br/>[SKILL.md]"]
end

subgraph group_install["Skill distribution"]
  node_installer["Installer<br/>[install.mjs]"]
  node_agent_platforms["Claude Code / opencode"]
end

subgraph group_maintain["Skill maintenance"]
  node_maintainer["Maintainer guidance<br/>[SKILL.md]"]
  node_survey["Upstream survey<br/>[survey.mjs]"]
  node_version_helpers["Version helpers<br/>[versions.mjs]"]
  node_drift["Drift check<br/>[check-drift.mjs]"]
end

node_developer(("Developer"))
node_agent(("Coding agent"))

node_developer -->|"asks about"| node_agent
node_agent -->|"selects guidance"| node_probe_skill
node_agent -->|"selects guidance"| node_migration
node_agent -->|"selects guidance"| node_modules
node_agent -->|"selects guidance"| node_process
node_agent -->|"selects guidance"| node_bench
node_agent -->|"selects guidance"| node_histogram
node_agent -->|"selects guidance"| node_test
node_agent -->|"selects guidance"| node_utilities
node_agent -->|"selects guidance"| node_sqlite
node_agent -->|"selects guidance"| node_zip
node_agent -->|"selects guidance"| node_streams
node_agent -->|"selects guidance"| node_crypto
node_agent -->|"selects guidance"| node_permissions
node_agent -->|"selects guidance"| node_diagnostics
node_agent -->|"selects guidance"| node_networking
node_agent -->|"selects guidance"| node_vfs
node_agent -->|"selects guidance"| node_ffi
node_agent -->|"selects guidance"| node_quic
node_developer -->|"installs skills"| node_installer
node_installer -->|"installs into"| node_agent_platforms
node_developer -->|"requests updates"| node_maintainer
node_maintainer -->|"surveys APIs"| node_survey
node_survey -->|"checks versions"| node_version_helpers
node_maintainer -->|"checks drift"| node_drift

click node_probe_skill "https://github.com/jasnell/node-skills/blob/main/skills/node-experimental-check/SKILL.md"
click node_migration "https://github.com/jasnell/node-skills/blob/main/skills/node-modern-migration/SKILL.md"
click node_modules "https://github.com/jasnell/node-skills/blob/main/skills/node-modules-loading/SKILL.md"
click node_process "https://github.com/jasnell/node-skills/blob/main/skills/node-process-timeout/SKILL.md"
click node_bench "https://github.com/jasnell/node-skills/blob/main/skills/node-bench/SKILL.md"
click node_histogram "https://github.com/jasnell/node-skills/blob/main/skills/node-histogram-stats/SKILL.md"
click node_test "https://github.com/jasnell/node-skills/blob/main/skills/node-test-runner/SKILL.md"
click node_utilities "https://github.com/jasnell/node-skills/blob/main/skills/node-utilities/SKILL.md"
click node_sqlite "https://github.com/jasnell/node-skills/blob/main/skills/node-sqlite/SKILL.md"
click node_zip "https://github.com/jasnell/node-skills/blob/main/skills/node-zip/SKILL.md"
click node_streams "https://github.com/jasnell/node-skills/blob/main/skills/node-stream-iter/SKILL.md"
click node_crypto "https://github.com/jasnell/node-skills/blob/main/skills/node-crypto/SKILL.md"
click node_permissions "https://github.com/jasnell/node-skills/blob/main/skills/node-permissions/SKILL.md"
click node_diagnostics "https://github.com/jasnell/node-skills/blob/main/skills/node-diagnostics/SKILL.md"
click node_networking "https://github.com/jasnell/node-skills/blob/main/skills/node-networking/SKILL.md"
click node_vfs "https://github.com/jasnell/node-skills/blob/main/skills/node-vfs/SKILL.md"
click node_ffi "https://github.com/jasnell/node-skills/blob/main/skills/node-ffi/SKILL.md"
click node_quic "https://github.com/jasnell/node-skills/blob/main/skills/node-quic-dtls/SKILL.md"
click node_installer "https://github.com/jasnell/node-skills/blob/main/install/install.mjs"
click node_maintainer "https://github.com/jasnell/node-skills/blob/main/.claude/skills/node-skills-maintainer/SKILL.md"
click node_survey "https://github.com/jasnell/node-skills/blob/main/tools/survey.mjs"
click node_version_helpers "https://github.com/jasnell/node-skills/blob/main/tools/versions.mjs"
click node_drift "https://github.com/jasnell/node-skills/blob/main/tools/check-drift.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_probe_skill,node_migration toneBlue
class node_modules,node_process,node_bench,node_histogram,node_test,node_utilities,node_sqlite,node_zip,node_streams,node_crypto,node_permissions,node_diagnostics,node_networking,node_vfs,node_ffi,node_quic toneAmber
class node_installer,node_agent_platforms toneMint
class node_maintainer,node_survey,node_version_helpers,node_drift toneRose
class node_developer,node_agent toneIndigo
```

## Components

### Probe and migration

- [Experimental check](https://github.com/jasnell/node-skills/blob/main/skills/node-experimental-check/SKILL.md): `skills/node-experimental-check/SKILL.md`
- [Modern migration](https://github.com/jasnell/node-skills/blob/main/skills/node-modern-migration/SKILL.md): `skills/node-modern-migration/SKILL.md`

### Node.js API skills

- [Module loading](https://github.com/jasnell/node-skills/blob/main/skills/node-modules-loading/SKILL.md): `skills/node-modules-loading/SKILL.md`
- [Process timeout](https://github.com/jasnell/node-skills/blob/main/skills/node-process-timeout/SKILL.md): `skills/node-process-timeout/SKILL.md`
- [Benchmarking](https://github.com/jasnell/node-skills/blob/main/skills/node-bench/SKILL.md): `skills/node-bench/SKILL.md`
- [Histogram stats](https://github.com/jasnell/node-skills/blob/main/skills/node-histogram-stats/SKILL.md): `skills/node-histogram-stats/SKILL.md`
- [Test runner](https://github.com/jasnell/node-skills/blob/main/skills/node-test-runner/SKILL.md): `skills/node-test-runner/SKILL.md`
- [Utilities](https://github.com/jasnell/node-skills/blob/main/skills/node-utilities/SKILL.md): `skills/node-utilities/SKILL.md`
- [SQLite](https://github.com/jasnell/node-skills/blob/main/skills/node-sqlite/SKILL.md): `skills/node-sqlite/SKILL.md`
- [ZIP archives](https://github.com/jasnell/node-skills/blob/main/skills/node-zip/SKILL.md): `skills/node-zip/SKILL.md`
- [Stream iteration](https://github.com/jasnell/node-skills/blob/main/skills/node-stream-iter/SKILL.md): `skills/node-stream-iter/SKILL.md`
- [Cryptography](https://github.com/jasnell/node-skills/blob/main/skills/node-crypto/SKILL.md): `skills/node-crypto/SKILL.md`
- [Permissions](https://github.com/jasnell/node-skills/blob/main/skills/node-permissions/SKILL.md): `skills/node-permissions/SKILL.md`
- [Diagnostics](https://github.com/jasnell/node-skills/blob/main/skills/node-diagnostics/SKILL.md): `skills/node-diagnostics/SKILL.md`
- [Networking](https://github.com/jasnell/node-skills/blob/main/skills/node-networking/SKILL.md): `skills/node-networking/SKILL.md`
- [Virtual filesystem](https://github.com/jasnell/node-skills/blob/main/skills/node-vfs/SKILL.md): `skills/node-vfs/SKILL.md`
- [Foreign functions](https://github.com/jasnell/node-skills/blob/main/skills/node-ffi/SKILL.md): `skills/node-ffi/SKILL.md`
- [QUIC and DTLS](https://github.com/jasnell/node-skills/blob/main/skills/node-quic-dtls/SKILL.md): `skills/node-quic-dtls/SKILL.md`

### Skill distribution

- [Installer](https://github.com/jasnell/node-skills/blob/main/install/install.mjs): `install/install.mjs`
- **Claude Code / opencode**

### Skill maintenance

- [Maintainer guidance](https://github.com/jasnell/node-skills/blob/main/.claude/skills/node-skills-maintainer/SKILL.md): `.claude/skills/node-skills-maintainer/SKILL.md`
- [Upstream survey](https://github.com/jasnell/node-skills/blob/main/tools/survey.mjs): `tools/survey.mjs`
- [Version helpers](https://github.com/jasnell/node-skills/blob/main/tools/versions.mjs): `tools/versions.mjs`
- [Drift check](https://github.com/jasnell/node-skills/blob/main/tools/check-drift.mjs): `tools/check-drift.mjs`

### Other components

- **Developer**
- **Coding agent**

## Connections

- Developer → Coding agent: asks about (evidence: `README.md`)
- Coding agent → Experimental check: selects guidance (evidence: `README.md`)
- Coding agent → Modern migration: selects guidance (evidence: `README.md`)
- Coding agent → Module loading: selects guidance (evidence: `README.md`)
- Coding agent → Process timeout: selects guidance (evidence: `README.md`)
- Coding agent → Benchmarking: selects guidance (evidence: `README.md`)
- Coding agent → Histogram stats: selects guidance (evidence: `README.md`)
- Coding agent → Test runner: selects guidance (evidence: `README.md`)
- Coding agent → Utilities: selects guidance (evidence: `README.md`)
- Coding agent → SQLite: selects guidance (evidence: `README.md`)
- Coding agent → ZIP archives: selects guidance (evidence: `README.md`)
- Coding agent → Stream iteration: selects guidance (evidence: `README.md`)
- Coding agent → Cryptography: selects guidance (evidence: `README.md`)
- Coding agent → Permissions: selects guidance (evidence: `README.md`)
- Coding agent → Diagnostics: selects guidance (evidence: `README.md`)
- Coding agent → Networking: selects guidance (evidence: `README.md`)
- Coding agent → Virtual filesystem: selects guidance (evidence: `README.md`)
- Coding agent → Foreign functions: selects guidance (evidence: `README.md`)
- Coding agent → QUIC and DTLS: selects guidance (evidence: `README.md`)
- Developer → Installer: installs skills (evidence: `README.md`)
- Installer → Claude Code / opencode: installs into (evidence: `install/install.mjs`)
- Developer → Maintainer guidance: requests updates (evidence: `README.md`)
- Maintainer guidance → Upstream survey: surveys APIs (evidence: `README.md`)
- Upstream survey → Version helpers: checks versions (evidence: `tools/survey.mjs`)
- Maintainer guidance → Drift check: checks drift (evidence: `README.md`)
