Best Practices
The prompt transformer for Claude Code.
A skill that transforms vague prompts into optimized instructions.
Installation
bash
npx ai-agent-skills add best-practicesbash
npx add-skill https://github.com/skillcreatorai/Ai-Agent-Skills/tree/main/skills/best-practicesSupports Claude Code, Cursor, OpenCode and more.
Usage
/best-practices fix the login bugWhat It Does
# Beforefix the login bug# Afterusers report login fails after session timeout.check the auth flow in src/auth/, especially token refresh.write a failing test that reproduces the issue, then fix it.verify by running the auth test suite.The 5 Principles
| Principle | Add |
|---|---|
| 1. Verification | Tests, screenshots, success criteria |
| 2. Context | Specific files, functions, line numbers |
| 3. Constraints | What NOT to do, scope boundaries |
| 4. Phases | Explore → Plan → Implement → Verify |
| 5. Rich Content | Actual errors, screenshots, @files |
Examples
# Bug fix"fix the bug" → symptom + location + failing test# Feature"add search" → pattern reference + test cases + constraints# Refactor"make it better" → specific changes + verification after each# Performance"it's slow" → endpoint + target metric + profiling approachModes
---
name: transform-directly
description: Apply best practices and output improved prompt immediately.
---
---
name: build-context-first
description: Launch 3 parallel agents to gather codebase context.
---
Context Agents
---
name: task-intent-analyzer
description: Analyze task type, identify gaps, surface edge cases.
---
---
name: best-practices-referencer
description: Find matching examples and patterns from references.
---
---
name: codebase-context-builder
description: Explore codebase for files, patterns, conventions.
---