📡 You're offline — showing cached content
New version available!
Quick Access
Tutorials Prompt Engineering Instruction Clarity

Instruction Clarity

5 min read Quiz at the end
Specificity is the single biggest lever in prompt quality — replace vague instructions with exact requirements.

Writing Clear Instructions

Vague instructions produce vague outputs. Specificity is the highest-impact improvement you can make.

# VAGUE vs SPECIFIC

VAGUE: 'Write a blog post about AI'
SPECIFIC:
'Write a 600-word blog post titled How AI is Changing Software Testing
 for QA engineers. Include 3 real-world examples.
 Use subheadings every 150 words.
 Tone: professional but conversational.
 End with a call to action.'

VAGUE: 'Make this shorter'
SPECIFIC:
'Reduce this text to 150 words while keeping all technical facts.
 Remove filler phrases and passive voice.
 Keep all numbered steps intact.'

VAGUE: 'Fix the code'
SPECIFIC:
'The function returns None when input list is empty.
 Fix it to return [] instead.
 Do not change any other behaviour.',

# Use positive instructions (what TO do)
BAD:  'Do not use technical jargon'
GOOD: 'Use simple language a high school student could understand'
Topic Quiz · 1 questions

Test your understanding before moving on

1. Which is the better instruction?
💡 Positive instructions (what TO do) are more effective than negative instructions (what NOT to do).