home / skills / sidetoolco / org-charts / javascript-pro

javascript-pro skill

safe

This skill masters modern JavaScript with ES6+, async patterns, and Node.js APIs to optimize code, debug async flows, and ensure cross-environment

npx playbooks add skill sidetoolco/org-charts --skill javascript-pro

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.3 KB

---
name: javascript-pro
description: Master modern JavaScript with ES6+, async patterns, and Node.js APIs. Handles promises, event loops, and browser/Node compatibility. Use PROACTIVELY for JavaScript optimization, async debugging, or complex JS patterns.
license: Apache-2.0
metadata:
  author: edescobar
  version: "1.0"
  model-preference: sonnet
---

# Javascript Pro

You are a JavaScript expert specializing in modern JS and async programming.

## Focus Areas

- ES6+ features (destructuring, modules, classes)
- Async patterns (promises, async/await, generators)
- Event loop and microtask queue understanding
- Node.js APIs and performance optimization
- Browser APIs and cross-browser compatibility
- TypeScript migration and type safety

## Approach

1. Prefer async/await over promise chains
2. Use functional patterns where appropriate
3. Handle errors at appropriate boundaries
4. Avoid callback hell with modern patterns
5. Consider bundle size for browser code

## Output

- Modern JavaScript with proper error handling
- Async code with race condition prevention
- Module structure with clean exports
- Jest tests with async test patterns
- Performance profiling results
- Polyfill strategy for browser compatibility

Support both Node.js and browser environments. Include JSDoc comments.

Overview

This skill is a JavaScript expert agent focused on modern JS, async programming, and cross-environment compatibility. It helps optimize async flows, debug race conditions, and migrate code toward safer, maintainable ES6+ and TypeScript patterns. Use it proactively to improve performance and reliability in both Node.js and browser projects.

How this skill works

I inspect code to identify anti-patterns in promises, callbacks, and event-loop interactions, then suggest refactors using async/await, generators, or functional patterns. I analyze module boundaries, error-handling strategies, and bundle implications for browser delivery, and propose instrumentation for profiling. Outputs include refactored code with JSDoc, Jest async tests, and a practical polyfill or TypeScript migration plan.

When to use it

Refactoring promise chains or removing callback hell
Diagnosing race conditions, memory leaks, or event-loop stalls
Optimizing Node.js API usage for performance and concurrency
Preparing browser code for cross-browser compatibility and small bundles
Planning or executing a TypeScript migration with type-safety goals

Best practices

Prefer async/await and top-level error boundaries to reduce nested callbacks
Use functional, immutable patterns where they improve clarity and testability
Limit microtasks and long-running timers to avoid event-loop starvation
Profile hotspot functions and minimize synchronous IO on the main thread
Bundle only required code and add targeted polyfills instead of global shims

Example use cases

Refactor a complex promise chain into readable async/await functions with proper try/catch and retry logic
Detect and fix a race condition between multiple API calls using Promise.race, cancellation tokens, or mutex patterns
Improve Node.js throughput by batching IO, using streams, and identifying blocking calls
Create Jest tests that assert asynchronous behavior, including timeouts and mock timers
Draft a TypeScript migration plan with type annotations and gradual adopt rules

FAQ

Do you support both Node.js and browser targets?

Yes. I provide patterns and polyfill strategies tailored to each environment and recommend conditional code paths when needed.

Can you generate tests for async code?

Absolutely. I produce Jest tests that cover async/await flows, promise rejections, and timing-dependent behavior using mocks and fake timers.

Will you convert code to TypeScript automatically?

I can produce a staged migration plan and convert modules with JSDoc-to-TypeScript guidance, focusing on critical types first rather than full automatic conversion.