Best Practices

Transforms loose prompts into ones Claude can actually execute well. The core insight here is verification: adding test cases, screenshots, or concrete success criteria dramatically improves output quality. It also handles the context problem by either transforming directly or spinning up parallel agents to gather intent, codebase details, and relevant patterns first. The five principles (verification, context, constraints, phasing, rich content) are practical and specific. Most useful when you know what you want but your first pass at asking for it was too vague or missing the hooks Claude needs to self-correct.

skills.sh installs: 397
GitHub stars: 1.1K
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add skillcreatorai/ai-agent-skills --skill best-practices --agent claude-code

Installs into .claude/skills of the current project.

Files

Best Practices — Prompt Transformer

Transform prompts by adding what Claude needs to succeed.

Start Here

Based on user's request:

User provides a prompt to transform: → Ask using AskUserQuestion:

Question: "How should I improve this prompt?"
Header: "Mode"
Options:
1. Transform directly — "I'll apply best practices and output an improved version"
2. Build context first — "I'll gather codebase context and intent analysis first"

User asks to learn/understand: → Show the 5 Transformation Principles section

User asks for examples: → Link to references/before-after-examples.md

User asks to evaluate a prompt: → Use the Success Criteria eval rubric at the end of this document

If "Transform directly"

Apply the 5 principles below and output the improved prompt immediately.

If "Build context first"

Launch 3 parallel agents to gather context:

Run these agents IN PARALLEL using the Task tool:

- Task task-intent-analyzer("[user's prompt]")
- Task best-practices-referencer("[user's prompt]")
- Task codebase-context-builder("[user's prompt]")