Prompt Builder: a Claude skill for writing better prompts

A free Agent Skill that teaches Claude to turn a rough request, or a weak prompt, into a clear and complete one, using a simple six-part framework.

Ask Claude things like:

• "Write me a prompt for ChatGPT to plan a 3-day trip to Rome."
• "Improve this prompt, the answers I get are too generic: ..."
• "Review my system prompt and tell me what's missing."

Claude finds the missing pieces, asks at most a few short questions (or uses [placeholders] if you want speed), and hands back a copy-ready prompt with a short note on what changed.

The six-part framework

Part	What it answers
1. Task	What exactly should the AI produce?
2. Context	What background can't the AI know?
3. Audience and purpose	Who reads it, and what should happen next?
4. Format	Length, structure, tone
5. Example	A sample in the style you want
6. Avoid	Phrases, assumptions or content to leave out

Most weak AI answers come from vague prompts, not weak models. Giving the model what a capable new colleague would need fixes most of them.

What's inside

prompt-builder/
├── SKILL.md                 # Workflow and rules Claude follows
├── references/
│   ├── framework.md         # Each part in depth, safeguards, model notes
│   └── examples.md          # Before/after prompts
├── scripts/
│   ├── check_prompt.py      # Scores a prompt against the six parts
│   └── build_prompt.py      # Assembles a prompt from JSON fields
└── assets/
    └── template.md          # Blank fill-in template

The scripts use only the Python standard library.

Install

Claude.ai and the Claude desktop app

1. Download prompt-builder.zip from the latest release, or zip the prompt-builder folder yourself.
2. In Claude, go to Customize > Skills, click +, then Create skill > Upload a skill, and upload the ZIP.
3. Make sure the skill is toggled on.

See Anthropic's guide: Use Skills in Claude. Skills need code execution enabled.

Claude Code

Copy the folder into your personal or project skills directory:

git clone https://github.com/Hussain-Shahid-Javaid/claude-prompt-builder-skill.git
cp -r claude-prompt-builder-skill/prompt-builder ~/.claude/skills/        # all projects
# or
cp -r claude-prompt-builder-skill/prompt-builder .claude/skills/          # this project only

See Claude Code skills docs.

Use the scripts on their own

# Check a prompt
python3 prompt-builder/scripts/check_prompt.py my_prompt.txt
echo "write an email to my boss asking for a day off" | python3 prompt-builder/scripts/check_prompt.py

# Build a prompt from fields
python3 prompt-builder/scripts/build_prompt.py fields.json

Example check_prompt.py output:

Prompt check: 1/6 parts found (11 words)

  [x] Task
  [ ] Context
  [ ] Audience and purpose
  [ ] Format
  [ ] Example
  [ ] Avoid

Missing essentials: Context

Warnings:
  - Very short prompt (11 words). Most good prompts need at least a task, context and format.

fields.json keys: task (required), context, audience, format, example, avoid, plus optional booleans ask_questions and flag_uncertainty.

The checker uses simple heuristics. It points at likely gaps; it doesn't replace reading your prompt.

No Claude? Use the web version

The same framework is available as a free browser tool (no sign-up): AI Prompt Builder. The longer explanation is in How to write better AI prompts.

Contributing

Issues and pull requests are welcome, especially new before/after examples in references/examples.md and improvements to the checker's heuristics.

License

MIT. Made by PromptPulse.