javascript
Apply these opinionated JavaScript conventions whenever writing or reviewing JS or Node: ESM-first packaging, choosing between Promise combinators, error handling that doesn't swallow failures, AbortController for cancellation, keeping the event loop unblocked, and reaching for platform APIs before dependencies.
How do I install this agent skill?
npx skills add https://github.com/alexander-danilenko/cortex-claude-code-plugins --skill javascriptIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides architectural and stylistic guidelines for modern JavaScript and Node.js development. It contains no executable code or risky instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
JavaScript
House conventions for modern JavaScript and Node. Apply them to code you are writing or changing — don't refactor untouched files to match unless asked.
Conventions
- ESM everywhere. New packages get
"type": "module". Mixing CJS and ESM inside one package produces the dual-package hazard — two copies of a module with separate state, failing in ways that read like race conditions. - Match the combinator to the intent. Sequential
awaitin a loop serialises independent work;Promise.alldrops the whole batch on one rejection;allSettledis for when partial success is acceptable. The wrong choice is a latency bug or a swallowed-error bug, and both look fine in review. - Every
catchhandles or rethrows. Acatchthat logs and continues converts a failure into corrupt state further downstream, where the stack trace no longer points at the cause. If there is nothing useful to do, don't catch. AbortControllerfor anything cancellable — fetches, timers, streams, listeners ({ signal }). Without it an abandoned request keeps its handler and its closure alive.- Never block the event loop. No
readFileSync, no long synchronous parse or crypto on a request path: Node serves every other request from that thread. CPU-bound work goes to a worker thread. - Don't mutate arguments. A function that edits its input changes the caller's object with no assignment in sight. Return new values — and reach for the non-mutating array methods that exist for exactly this:
toSorted,toReversed,toSpliced,with.arr.sort()sorting the caller's array in place is one of the most common accidental mutations in JS. node:prefix on builtins. Unambiguous, and immune to shadowing by a userland package of the same name.- Reach for the platform before a dependency.
structuredClone,Intl,URL/URLSearchParams,crypto.randomUUID,Array.prototype.at/findLast,Object.groupBycover most of what utility libraries were installed for.
Publishing a package
The exports map is the public surface — anything not listed is unreachable, which is the point: it lets you refactor internals without breaking consumers. Declare sideEffects: false (or list the files that have them) so bundlers can drop unused exports; without it, tree shaking has to assume importing your module does something and keeps all of it.
{
"type": "module",
"exports": {
".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
"./package.json": "./package.json"
},
"sideEffects": false
}
Two ESM facts that cost the most time when they bite: relative imports need the file extension (./utils.js, not ./utils), and there is no __dirname — derive it with fileURLToPath(import.meta.url), or createRequire(import.meta.url) when you genuinely need to load a CJS-only package.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/alexander-danilenko/cortex-claude-code-plugins/javascript">View javascript on skillZs</a>