Prompt Best Practices (Project Skill)

This skill is a curated set of rules for writing LLM prompts in this repo. Every prompt — system prompts, skill prompts, extraction templates, generation instructions — MUST pass these rules before going to /review-prompt.

The core problem: Agents write vague, hand-wavy prompts that sound reasonable but produce garbage output. "Analyze the document and extract relevant information" is not a prompt — it is a wish. This skill exists to kill that pattern.

When to Apply

Use this skill whenever you:

• write a new system prompt or skill prompt template
• modify an existing prompt in a .txt, .md, or inline Python string
• build prompts for /scillm, /code-runner, /prompt-lab, or any LLM call
• prepare a prompt for /review-prompt review

Categories (priority order)