Best Practices
Transforms vague prompts into optimized Claude Code prompts. Adds verification, specific context, constraints, and proper phasing. Invoke with /best-practices.
Install
npx skills add MoizIbnYousaf/ai-agent-skills --skill best-practicesgit clone --depth 1 https://github.com/MoizIbnYousaf/ai-agent-skills.git /tmp/ai-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ai-agent-skills/skills/best-practices ~/.claude/skills/best-practicesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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]")
```
### What Each Agent Returns
| Agent | Mission | Returns |
|-------|---------|---------|
| **task-intent-analyzer** | Understand what user is trying to do | Task type, gaps, edge cases, transformation guidance |
| **best-practices-referencer** | Find relevant patterns from references/ | Matching examples, anti-patterns to avoid, transformation rules |Details
- Skill name
best-practices- Repository
- MoizIbnYousaf/ai-agent-skills
- Path
skills/best-practices/SKILL.md- License
- MIT
- Repo updated
- 21 September 2026
- Listed in
- heilcheng/awesome-agent-skills
FAQ
What does the Best Practices skill do?
Transforms vague prompts into optimized Claude Code prompts. Adds verification, specific context, constraints, and proper phasing. Invoke with /best-practices.
How do I install the Best Practices skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add MoizIbnYousaf/ai-agent-skills --skill best-practices. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Best Practices popular?
It lives in MoizIbnYousaf/ai-agent-skills, which has 1,160 GitHub stars and 137 forks, and is included in 1 curated skill list.
Related skills
Content Research Writer
1.2kMoizIbnYousaf/ai-agent-skills
Conducts research, adds citations, and improves writing quality. Research topics thoroughly and produce well-cited content.
Changelog Generator
1.2kMoizIbnYousaf/ai-agent-skills
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Ask Questions If Underspecified
1.2kMoizIbnYousaf/ai-agent-skills
Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
Browse and Evaluate
1.2kMoizIbnYousaf/ai-agent-skills
Use when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing. Always use --fields to limit output size and --dry-run before committing to an install.
RAG Implementation
2krmyndharis/antigravity-skills
Build Retrieval-Augmented Generation (RAG) systems for LLM applications with vector databases and semantic search. Use when implementing knowledge-grounded AI, building document Q&A systems, or integrating LLMs with external knowledge bases.
Intelligent Prompt Generator
1.5khuangserva/skill-prompt-generator
智能提示词生成器 v2.0 - 支持人像/跨domain/设计三种模式,语义理解、常识推理、一致性检查
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.