Standards for self-documenting code and minimal comments. Use when auditing inline documentation or deciding when comments add value vs clutter.
Audits code comments for necessity, accuracy, and value, suggesting refactors to eliminate clutter.
/plugin marketplace add rileyhilliard/claude-essentials/plugin install ce@claude-essentialsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Core principle: The best comment is the one you didn't need to write.
| Avoid | Why |
|---|---|
// Get the user's name | Restates code |
@param {string} email | Types already document |
| Stale comments | Misleading > missing |
// Use exponential backoff - service rate-limits after 3 rapid failures
const backoffMs = Math.pow(2, attempts) * 1000;
// IMPORTANT: Assumes UTC - local timezone causes date drift
const dayStart = new Date(date.setHours(0, 0, 0, 0));
// Workaround for Safari flexbox bug (JIRA-1234)
// Per RFC 7231 §6.5.4, return 404 for missing resources
// Map for O(1) lookup - benchmarked 3x faster than array.find() at n>100
const userMap = new Map(users.map(u => [u.id, u]));
| Instead of comment | Refactor to |
|---|---|
// Get active users | const activeUsers = users.filter(u => u.isActive) |
// 86400000 ms = 1 day | const ONE_DAY_MS = 24 * 60 * 60 * 1000 |
// Handle error case | Extract to handleAuthError(err) |
// ✅ TODO(JIRA-567): Replace with batch API when available Q1 2025
// ❌ TODO: fix this later
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.