Menu
Clean Code principles for JavaScript and TypeScript. Covers naming, functions, classes, SOLID, testing, concurrency, error handling, formatting, and comments. Use when writing, refactoring, or reviewing JavaScript/TypeScript code.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Semantic code explanation that prioritizes why over what. Explains purpose, design decisions, and broader context of any code target. Accepts natural language: a file path, symbol name, line reference, directory, or question. Use when asked to "explain", "what does this do", "why is this here", or "walk me through".
Principles for designing context-efficient AI agents and tools. Use when designing LLM tools, agents, MCP servers, or multi-agent systems.
Create a GitHub PR from the current feature branch. Auto-detects base branch, learns PR conventions from recent PRs, and generates a concise summary with a review guide. Use when asked to "create a PR", "open a PR", "make a pull request", or "submit PR".
Single-pass code review focused on clean code principles and OOP best practices. Auto-detects mode: PR number in arguments triggers PR mode (reads existing comments), uncommitted changes trigger local mode, feature branch triggers branch mode. Use when asked to "review code", "code review", "review my changes", or "review PR #N".
| name | clean-code-js |
| description | Clean Code principles for JavaScript and TypeScript. Covers naming, functions, classes, SOLID, testing, concurrency, error handling, formatting, and comments. Use when writing, refactoring, or reviewing JavaScript/TypeScript code. |
| allowed-tools | ["Read","Glob","Grep"] |
Software engineering principles from Robert C. Martin's Clean Code, adapted for JavaScript by Ryan McDermott (source).
These are guidelines, not rules. Not every principle must be followed strictly, and few are universally agreed upon. They are distilled from many years of collective experience — apply judgment.
code-review skill)| # | Category | File | Focus |
|---|---|---|---|
| 1 | Variables | 01-variables.md | Meaningful names, searchability, default parameters |
| 2 | Functions | 02-functions.md | Argument count, single responsibility, side effects, abstraction levels |
| 3 | Objects and Data Structures | 03-objects-and-data.md | Getters/setters, private members |
| 4 | Classes | 04-classes.md | ES6 classes, method chaining, composition over inheritance |
| 5 | SOLID | 05-solid.md | SRP, OCP, LSP, ISP, DIP |
| 6 | Testing | 06-testing.md | Single concept per test |
| 7 | Concurrency | 07-concurrency.md | Promises, async/await over callbacks |
| 8 | Error Handling | 08-error-handling.md | Don't swallow errors or rejected promises |
| 9 | Formatting | 09-formatting.md | Consistent capitalization, caller/callee proximity |
| 10 | Comments | 10-comments.md | Comment only non-obvious "why", not "what" |