Professional Writing Styles
Journalistic, persuasive, instructional, and technical writing modes.
Professional Writing Styles is a free AI Prompt Engineering lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the AI Prompt Engineering learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Styles That Structure Thinking
Professional writing is not just about tone — it is about structure and intent. Different professions have evolved distinct writing styles, each designed to serve a specific communication goal.
Knowing these styles and how to request them gives you access to a library of proven writing patterns: journalistic, persuasive, instructional, and technical.
Journalistic Style: The Inverted Pyramid
Journalistic style uses the inverted pyramid: most important information first, supporting details second, background last.
Characteristics:
- Lead sentence answers: who, what, when, where, why
- Each paragraph can stand alone
- No setup — get to the point immediately
- Short sentences and paragraphs
- No conclusions — the story speaks for itself
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write in journalistic inverted-pyramid style. '
'Lead immediately with the most important fact. '
'No setup, no preamble. Short sentences, short paragraphs. '
'Max 100 words.\n\n'
'Announce: Anthropic has released Claude 4, achieving a new benchmark score of 94% '
'on a standard reasoning test, surpassing previous models by 8 percentage points. '
'Available via API today. Pricing unchanged.'
)
}]
)
print(response.content[0].text)Journalistic Style for Business Content
The inverted pyramid works for more than news. Use journalistic style for:
- Internal memos where leaders skim the first paragraph
- Product release notes read by busy engineers
- Executive briefings where time is extremely limited
- Email subject lines and opening sentences
Request: 'Write this in journalistic style — most important fact in the first sentence, rest as supporting detail.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write an internal engineering memo using journalistic style. '
'Most critical information in sentence 1. Max 3 short paragraphs.\n\n'
'Facts: We will have a 30-minute planned downtime on Saturday, March 15 at 2 AM UTC. '
'Cause: database migration to PostgreSQL 16. '
'Impact: all API endpoints unavailable. '
'Action needed: engineers should not deploy during this window. '
'Status page will show updates.'
)
}]
)
print(response.choices[0].message.content)Persuasive Style: Problem-Solution
Persuasive writing follows a clear structure: establish the problem, then present the solution as the answer. Also called the PAS framework:
- Problem — agitate the pain the reader experiences
- Agitate — deepen the emotional resonance of the problem
- Solution — present your offering as the resolution
Use for: sales copy, proposals, pitch decks, grant applications, change management memos.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write landing page copy using the Problem-Agitate-Solution (PAS) persuasive framework.\n'
'Structure:\n'
'- Paragraph 1 (Problem): name the pain clearly\n'
'- Paragraph 2 (Agitate): make the reader feel how serious this problem is\n'
'- Paragraph 3 (Solution): introduce the product as the answer\n'
'Product: A tool that automatically generates commit messages from git diffs.\n'
'Audience: developers who write bad or no commit messages under time pressure.\n'
'Max 150 words total.'
)
}]
)
print(response.content[0].text)Persuasive Style: AIDA Framework
The AIDA framework is another persuasive structure widely used in marketing:
- Attention — hook the reader immediately
- Interest — build curiosity and relevance
- Desire — create emotional want for the solution
- Action — clear CTA (call to action)
Request: 'Write this using the AIDA framework: Attention, Interest, Desire, Action.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a cold email using the AIDA framework. '
'Label each section: [ATTENTION], [INTEREST], [DESIRE], [ACTION].\n'
'Product: AI-powered code review tool that catches security bugs.\n'
'Audience: CTO at a 50-150 person software company.\n'
'Length: max 150 words. Tone: direct, professional, no hype.'
)
}]
)
print(response.choices[0].message.content)Instructional Style: Step-by-Step
Instructional writing guides the reader through a process. It prioritizes:
- Numbered steps — each action clearly separated
- Imperative verbs — 'Click', 'Enter', 'Select', 'Run'
- One action per step — no multi-action steps
- Explicit prerequisites — what the reader needs before starting
- Verification steps — how to confirm each step worked
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Write step-by-step instructional documentation for setting up a Python virtual environment.\n'
'Style rules:\n'
'- Begin with Prerequisites (1-3 items)\n'
'- Number every step\n'
'- Start each step with an imperative verb\n'
'- Maximum one action per step\n'
'- Include the exact command to run in a bash code block where applicable\n'
'- Add a verification command after every 2-3 steps\n'
'Audience: first-year developer who knows Python basics but never used a terminal.'
)
}]
)
print(response.content[0].text)Instructional Style: How-To Articles
How-to articles are a specific form of instructional writing for web content. They follow this structure:
- Hook — why this matters in 1-2 sentences
- What you will learn (brief)
- Prerequisites
- Steps (numbered, clear)
- Result — what the reader has after completing
- Next steps or further reading
Request each section explicitly to get the right structure.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a how-to article outline (headings + 1-sentence descriptions only) '
'for "How to Set Up GitHub Actions for Python Testing".\n'
'Include exactly:\n'
'- 1 hook sentence\n'
'- What You Will Learn section (3 bullets)\n'
'- Prerequisites section (3 bullets)\n'
'- 5 numbered steps with H3 headings\n'
'- Final Result section (1 sentence)\n'
'- 2 Next Steps bullets\n'
'No body content — outline only.'
)
}]
)
print(response.choices[0].message.content)Technical Style: Precise and Concise
Technical writing prioritizes precision over persuasion, and conciseness over warmth. Characteristics:
- Define all terms on first use
- Use consistent terminology throughout (no synonyms for technical terms)
- Short, direct sentences — average 12-15 words
- Active voice predominantly
- Quantify everything that can be quantified
- No metaphors or analogies unless they add precision
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write technical documentation for a Python function that rate-limits API calls.\n'
'Technical style rules:\n'
'- Define every parameter and return value precisely\n'
'- Include type annotations in the description\n'
'- Quantify all behaviors (e.g., "raises ValueError after 3 retries")\n'
'- Active voice, no passive\n'
'- Max 15 words per sentence\n'
'- No analogies or metaphors\n'
'Function: takes a callable, max_calls (int), window_seconds (int). '
'Returns a wrapped callable that enforces the rate limit.'
)
}]
)
print(response.content[0].text)Choosing the Right Style
Matching the style to the goal is the key skill:
- Journalistic: news, memos, announcements where skimming is expected
- Persuasive (PAS/AIDA): sales, marketing, change management, proposals
- Instructional: how-to guides, onboarding, technical tutorials
- Technical: API docs, specification documents, engineering RFCs
Most real documents combine styles: a blog post might use journalistic in the intro, instructional in the body, and a persuasive CTA at the end.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
# Hybrid style: journalistic intro + instructional body + persuasive CTA
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a 3-section technical blog post intro for "How to Cut Your AWS Bill by 40%".\n'
'Section 1 (Journalistic): 1 sentence hook — state the key finding immediately.\n'
'Section 2 (Instructional): 3-bullet overview of what the reader will learn/do.\n'
'Section 3 (Persuasive): 1 sentence CTA to continue reading.\n'
'Audience: AWS-using startup CTOs. Tone: direct, no hype.'
)
}]
)
print(response.choices[0].message.content)Style Consistency Across Sections
Style inconsistency within a single document is jarring. A persuasive opening followed by dry technical prose breaks reading flow. Keep these rules when mixing styles:
- Use the dominant style for at least 70% of the content
- Transition phrases help when switching (e.g., 'Here is how to get started:')
- Define style for each section explicitly in the prompt if you need a hybrid
- Always end with the same style you started — it feels complete
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=300,
messages=[{
'role': 'user',
'content': (
'Write a product launch announcement combining three styles — '
'label each section.\n\n'
'[JOURNALISTIC LEAD]: 2-sentence news-style announcement of the launch.\n'
'[PERSUASIVE VALUE]: 2-sentence why-it-matters with problem-solution framing.\n'
'[INSTRUCTIONAL NEXT STEP]: 3 numbered steps to get started.\n\n'
'Product: Sentry AI — error monitoring with automatic root cause analysis.\n'
'Audience: developer teams who currently spend hours debugging production errors.'
)
}]
)
print(response.content[0].text)Naming the Style in Your Prompt
The simplest way to activate a professional writing style is to name it directly in your prompt:
- 'Write this in journalistic inverted-pyramid style'
- 'Use the PAS (Problem-Agitate-Solution) framework'
- 'Write step-by-step instructional documentation'
- 'Write in technical documentation style — precise and concise'
The model recognizes these style names and applies the associated structural patterns automatically. No further description is usually needed.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
style_names = [
'journalistic inverted-pyramid style',
'PAS (Problem-Agitate-Solution) persuasive framework',
'step-by-step instructional documentation style',
'technical documentation style — precise and concise'
]
topic = 'how to reset a forgotten password in our web app'
for style in style_names:
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=80,
messages=[{
'role': 'user',
'content': f'Write about {topic} using {style}. Max 3 sentences or 3 steps.'
}]
)
print(f'Style: {style[:45]}...')
print(response.content[0].text.strip())
print()Knowledge Check
A developer is writing onboarding documentation for a new API. They want users to successfully complete the authentication setup without needing to contact support. Which writing style is most appropriate as the primary style?
Professional Writing Styles — Recap
Four professional writing styles and when to use each:
- Journalistic: inverted pyramid, most important first, short sentences — for memos, announcements, news
- Persuasive (PAS/AIDA): problem → agitate → solution or attention → interest → desire → action — for sales, marketing, proposals
- Instructional: numbered steps, imperative verbs, one action per step, verification — for how-to guides, tutorials, onboarding
- Technical: precise, concise, defined terms, quantified behaviors — for API docs, RFCs, specifications
Name the style in your prompt and the model applies its structural patterns automatically.
Frequently asked questions
Is the “Professional Writing Styles” lesson free?
Yes — the full text of “Professional Writing Styles” is free to read here on the web, and the AI Prompt Engineering course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the AI Prompt Engineering course, upgrade to CoddyKit PRO.
What will I learn in “Professional Writing Styles”?
Journalistic, persuasive, instructional, and technical writing modes. You practise AI Prompt Engineering with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start AI Prompt Engineering?
No prior experience is required. AI Prompt Engineering on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Professional Writing Styles” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this AI Prompt Engineering lesson?
Yes. Every AI Prompt Engineering lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Formal vs Informal Tone
- Specifying Your Audience
- Professional Writing Styles
- Adjusting Vocabulary Level