Content Writer v2.0

Session Tracking:

• Only show notification once per Claude Code session
• Reset when Claude Code restarts
• Skip check if already shown in current session

System Overview

Content Writer v2.0 uses a GSD-style phased workflow inspired by Get Shit Done methodology. Instead of generating content in one step, it follows a structured process that ensures quality, SEO optimization, and human-like voice.

The Five Phases

1. Discuss — Gather requirements, clarify decisions, identify gray areas
2. Plan — Research approach, select framework, create execution plan
3. Execute — Generate content following the plan and best practices
4. Verify — Run SEO check (claude-seo) and anti-AI audit (humanizer)
5. Ship — Save to file, present to user with publishing notes

Why Phased Workflow?

• Higher Quality — Each phase has a specific purpose and deliverables
• Better SEO — Integrated optimization throughout the process
• More Human — Anti-AI audit catches patterns you might miss
• Professional — Matches proven development methodologies
• Transparent — Clear progress and decision points

Core Commands

Phased Workflow Commands

/writer:discuss [topic] Start a new content project. Gathers requirements, clarifies decisions, identifies content type and framework.

/writer:plan Research and plan the content. Selects framework, creates outline, defines SEO strategy.

/writer:execute Generate the content following the plan. Applies selected framework and best practices.

/writer:verify Quality check. Runs SEO optimization (claude-seo) and anti-AI audit (humanizer).

/writer:ship Finalize and save. Generates markdown file with metadata and publishing notes.

/writer:next Auto-advance to the next phase. Detects current phase and runs the next step automatically.

Profile Management Commands

/writer:profile-create Create a new writer profile with URL scanning and comprehensive questionnaire.

/writer:profile-view View current writer profile and all stored information.

/writer:profile-edit Edit existing writer profile, products, CTAs, or case studies.

/writer:profile-delete Delete writer profile and all associated data.

Quick Commands

/writer:help Show available commands and current workflow status.

/writer:status Show current phase, profile status, and next steps.

/writer:update Check for updates and upgrade to the latest version. Shows changelog preview before updating.

Profile-First Enforcement

CRITICAL: Content Writer v2.0 requires a writer profile before generating any content.

Profile Check Flow

User: "/writer:discuss blog post about X"
↓
System: Check for profile in memory
↓
Profile exists? NO
↓
" No writer profile found. Let's create one first."
"A profile ensures your content has consistent voice and quality."
↓
Run /writer:profile-create
↓
After completion → Return to original request

Why Profile-First?

• Consistent Voice — Every piece sounds like you
• Better Quality — No generic AI content
• Professional Workflow — Proper setup before execution
• Richer Context — More information = better content

Profile Creation Workflow

Step 1: URL Scanning (Optional but Recommended)

Prompt:

Let's create your writer profile! This helps me write content that sounds like YOU.

First, do you have any URLs I can analyze to detect your tone and voice?
(Blog posts, articles, social media posts, etc.)

You can provide:
• Multiple URLs (the more, the better)
• Or skip this step and I'll build your profile from scratch

Paste URLs below (one per line) or type "skip":

If URLs provided:

1. Fetch each URL using read_url_content

2. Analyze for:

   • Sentence structure (length, complexity, variety)
   • Vocabulary (technical vs. casual, jargon usage)
   • Tone markers (formal/informal, serious/playful)
   • Personality indicators (humor, anecdotes, opinions)
   • Formatting preferences (paragraph length, lists, emphasis)

3. Generate tone profile:

Based on your content, I detected:
• Tone: [Direct, conversational, data-driven]
• Sentence style: [Mix of short punchy sentences and longer explanatory ones]
• Vocabulary: [Technical but accessible, minimal jargon]
• Personality: [Confident, slightly irreverent, uses specific examples]
• Formatting: [Short paragraphs, frequent subheadings, bullet points]

Does this sound right? (yes/no/adjust)

Step 2: Comprehensive Brand Questionnaire

Interactive format with numbered options where applicable.

2.1 Brand Identity

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Brand Identity (1/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. What's your name and title?
   (This appears as the byline on all content)

2. What's your company/brand name?

3. Company website/domain?

4. Tagline or mission statement? (optional)

5. What does your company do? (1-2 sentences, in your words)

2.2 Industry & Market

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Industry & Market (2/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. What industry/niche are you in?
   Examples: SaaS, E-commerce, Healthcare, Consulting, etc.

2. Who are your main competitors?
   (List 2-3 companies)

3. What makes you different from competitors?
   (Your unique positioning)

2.3 Target Audience

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Target Audience (3/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Who is your primary audience?
   Be specific: "startup founders", "marketing directors at mid-market SaaS", 
   "small business owners in healthcare", etc.

2. What are their main pain points?
   (What problems do they face?)

3. What are their goals?
   (What do they want to achieve?)

4. What objections might they have?
   (Why might they hesitate?)

2.4 Voice & Tone

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Voice & Tone (4/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[If URL scanning was done, show detected tone and ask for confirmation]

1. Pick 3-5 adjectives that describe your ideal writing voice:

   Select from these options (or provide your own):
   1. Direct          7. Provocative      13. Witty
   2. Warm            8. Authoritative    14. Humble  
   3. Irreverent      9. Data-driven      15. Technical
   4. Conversational  10. Storytelling    16. Casual
   5. Professional    11. Empathetic      17. Bold
   6. Confident       12. Educational     18. Other: _____

2. Are there voices or writers you admire?
   (Blogs, newsletters, authors — helps calibrate)

3. Anything you specifically want to AVOID?
   Examples: Corporate jargon, emojis, exclamation marks, overly casual, etc.

2.5 Content Strategy

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Content Strategy (5/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. What types of content do you create?
   Select all that apply:
   1. Blog articles
   2. LinkedIn posts
   3. Twitter/X posts
   4. Instagram captions
   5. Facebook posts
   6. Email newsletters
   7. Email campaigns
   8. Email sequences
   9. Landing pages
   10. Web pages
   11. Product pages
   12. Sales funnels
   13. Case studies
   14. Testimonials
   15. Product descriptions
   16. Other: _____

2. What are your main content themes/pillars?
   (3-5 topics you write about regularly)

3. What's your primary content goal?
   Select one:
   1. Brand awareness (TOFU)
   2. Lead generation (MOFU)
   3. Customer conversion (BOFU)
   4. Thought leadership
   5. Community building
   6. Other: _____

4. Preferred article length?
   1. Short (800-1,200 words)
   2. Medium (1,500-2,000 words)
   3. Long (2,500+ words)
   4. Varies by topic

2.6 Products & Services

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Products & Services (6/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

List your main products/services (I'll reference these naturally in content):

For each, provide:
• Name
• Brief description (1 sentence)
• Target customer
• Key benefit
• Price range (optional)

Add first product/service:

After each entry:

 Added: [Product Name]

Add another? (yes/no)

2.7 Case Studies

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Case Studies (7/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Do you have case studies or success stories I can reference?

For each, provide:
• Client/project name (or "Anonymous" if NDA)
• Challenge/problem
• Solution/approach
• Results/outcomes (with metrics if possible)
• Can I mention this publicly? (yes/no/anonymized)

Add first case study (or type "skip"):

2.8 CTAs (Call-to-Actions)

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  CTAs (8/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What actions do you want readers to take?

Common CTAs:
• Book a call/demo
• Download a resource
• Subscribe to newsletter
• Follow on social media
• Visit website
• Contact for consultation

For each CTA, provide:
• Platform (blog, LinkedIn, Twitter, etc. or "all")
• CTA text
• URL (if applicable)

Add first CTA:

2.9 Publishing Workflow

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Publishing Workflow (9/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Where do you publish content?
   Select all that apply:
   1. Company blog
   2. Medium
   3. LinkedIn
   4. Twitter/X
   5. Instagram
   6. Facebook
   7. Email newsletter
   8. Other: _____

2. Do you have a content approval process?
   1. No approval needed (I publish directly)
   2. Self-review before publishing
   3. Team review required
   4. Other: _____

3. Preferred output format?
   1. Markdown
   2. Plain text
   3. HTML
   4. Platform-specific format

2.10 SEO Strategy

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SEO Strategy (10/10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Do you have target keywords or topics?
   (List 5-10 keywords/phrases you want to rank for)

2. SEO priority level?
   1. High (SEO is critical)
   2. Medium (SEO matters but not primary)
   3. Low (Focus on quality over SEO)

3. Any SEO constraints?
   (Word count requirements, keyword density, etc.)

Step 3: Profile Confirmation

Prompt:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Profile Complete!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Here's your writer profile:

**Brand Identity**
• Name: [Name & Title]
• Company: [Company Name]
• Domain: [Website]
• Industry: [Industry]

**Voice & Tone**
• Style: [Adjectives]
• Influences: [Writers/Blogs]
• Avoid: [Things to avoid]

**Target Audience**
• Primary: [Audience description]
• Pain points: [List]
• Goals: [List]

**Content Strategy**
• Types: [Content types]
• Themes: [Content pillars]
• Goal: [Primary goal]

**Products/Services**
• [List of products]

**Case Studies**
• [List of case studies]

**CTAs**
• [List of CTAs by platform]

**SEO**
• Keywords: [Target keywords]
• Priority: [High/Medium/Low]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Does this look correct? (yes/edit/cancel)

Step 4: Save Profile

On confirmation:

1. Save to memory using create_memory with title [Content Writer] Writer Profile
2. Save to file: content-writer-output/profile/PROFILE.md
3. Save products to: content-writer-output/profile/PRODUCTS.md
4. Save CTAs to: content-writer-output/profile/CTAS.md
5. Save case studies to: content-writer-output/profile/CASE-STUDIES.md

Success message:

 Profile saved successfully!

Your profile is stored in:
• Memory (for quick access)
• Files (for version control)

Location: content-writer-output/profile/

You're all set! Let's create some content.

To get started:
/writer:discuss "your topic here"

Phase 1: Discuss (Requirements Gathering)

Command: /writer:discuss [topic]

Goal: Understand what to write and why. Gather all necessary information before planning.

Workflow

Step 1: Profile Check

Check memory for writer profile
↓
Profile exists? NO → Run /writer:profile-create first
↓
Profile exists? YES → Continue

Step 2: Gather Requirements

Ask the user these questions (conversationally, not as a form):

1. Topic & Angle

   • What's the main topic?
   • What's your specific angle or perspective?
   • Any specific points you want to cover?

2. Content Type

   • What platform is this for?
     1. Blog article
     2. LinkedIn post
     3. Facebook post
     4. Instagram caption
     5. Twitter/X (single tweet)
     6. Twitter/X (thread)
     7. Email newsletter
     8. SEO metadata
     9. Content package (multiple platforms)

3. Audience & Goal

   • Who's the primary audience for this piece?
   • What do you want them to do after reading?
   • What stage of awareness? (Unaware/Problem-aware/Solution-aware/Product-aware)

4. Framework Selection

   • Based on the content type and goal, suggest appropriate framework:
     • AIDA (Attention-Interest-Desire-Action) — Sales pages, landing pages
     • PAS (Problem-Agitate-Solution) — Problem-focused content
     • BAB (Before-After-Bridge) — Transformation stories, case studies
     • LEMA (Logic-Explicitness-Memorability-Actionability) — Thought leadership
     • 4-Point (Hook-Effortless-Flow-Polish) — Long-form articles
     • CONVERT (Clarity-Outcome-Narrative-Value-Engagement-Relevance-Trigger) — Conversion-focused

   Ask: "I recommend [Framework] for this. Sound good, or prefer a different approach?"

5. Length & Format

   • Desired length? (Or use profile default)
   • Any specific formatting requirements?

6. Research Needs

   • Do you have any URLs I should analyze for inspiration?
   • Any specific data, stats, or sources to include?

7. CTAs & Next Steps

   • What CTA should I use? (Or use profile default)
   • Any specific links or resources to include?

Step 3: Summarize & Confirm

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Content Brief
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

**Topic:** [Topic and angle]
**Platform:** [Content type]
**Framework:** [Selected framework]
**Audience:** [Target audience]
**Goal:** [Primary objective]
**Length:** [Target word count]
**CTA:** [Call-to-action]

**Key Points:**
• [Point 1]
• [Point 2]
• [Point 3]

Ready to plan? (yes/edit)

Step 4: Save Discussion State

Save to memory: [Content Writer] Current Project - Discussion

Next Step:

 Discussion complete!

Next: /writer:plan
(Or use /writer:next to auto-advance)

Phase 2: Plan (Research & Strategy)

Command: /writer:plan

Goal: Research the topic, create detailed outline, define SEO strategy.

Workflow

Step 1: Load Discussion State

Load from memory: [Content Writer] Current Project - Discussion
↓
No discussion found? → "Please run /writer:discuss first"
↓
Discussion loaded → Continue

Step 2: Research (if URLs provided)

If user provided URLs in discuss phase:

1. Fetch each URL using read_url_content
2. Extract key insights, data points, angles
3. Identify gaps or opportunities
4. Note what to avoid (don't copy)

Step 3: Framework Application

Based on selected framework, create structure:

For AIDA:

Structure:
1. Attention (Headline + Hook)
   - Compelling headline
   - Opening that grabs immediately
   
2. Interest (Build engagement)
   - Relevant benefits or pain points
   - Specific examples
   
3. Desire (Create want)
   - Show transformation
   - Social proof
   - Address objections
   
4. Action (Clear CTA)
   - Specific next step
   - Remove friction

For PAS:

Structure:
1. Problem (Identify pain)
   - State the problem clearly
   - Make it relatable
   
2. Agitate (Make it urgent)
   - Show cost of inaction
   - Amplify the pain
   
3. Solution (Present answer)
   - Introduce your solution
   - Show how it solves the problem
   - Clear CTA

For BAB:

Structure:
1. Before (Current state)
   - Paint picture of life with problem
   - Be specific and relatable
   
2. After (Desired state)
   - Show the transformation
   - Make it tangible
   
3. Bridge (How to get there)
   - Explain your solution
   - Show the path
   - Clear CTA

For LEMA:

Structure:
1. Logic (Natural flow)
   - Organize ideas logically
   - Answers follow questions
   
2. Explicitness (Be specific)
   - Concrete examples
   - No vague language
   
3. Memorability (Make it stick)
   - Analogies, stories
   - Coined terms
   
4. Actionability (Clear steps)
   - What to do next
   - Pathway to results

For 4-Point:

Structure:
1. Hook Attention Early
   - Compelling headline
   - Strong intro
   
2. Make It Effortless to Read
   - Subheadings every 300-400 words
   - Short paragraphs
   - Bullet points
   
3. Maintain Narrative Flow
   - Smooth transitions
   - Logical progression
   
4. Polish Ruthlessly
   - Cut fluff
   - Strengthen CTA

For CONVERT:

Structure:
1. Clarity — Simple, easy to understand
2. Outcome — Show end result
3. Narrative — Tell a story
4. Value — Demonstrate value prop
5. Engagement — Interactive elements
6. Relevance — Speak to audience
7. Trigger — Strong CTA

Step 4: SEO Strategy (if applicable)

For blog articles and long-form content:

1. Identify primary keyword
2. List secondary keywords
3. Plan keyword placement (natural)
4. Define meta title and description
5. Plan internal/external links
6. Identify related topics to cover

Step 5: Outline Creation

Create detailed outline with:

• Section headings
• Key points per section
• Examples/data to include
• Where to place CTAs
• Estimated word count per section

Step 6: Present Plan

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Content Plan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

**Framework:** [Selected framework]

**Structure:**

[Detailed outline with sections, key points, examples]

**SEO Strategy:**
• Primary keyword: [keyword]
• Secondary keywords: [list]
• Meta title: [title]
• Meta description: [description]

**Estimated length:** [word count]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Ready to execute? (yes/edit)

Step 7: Save Plan State

Save to memory: [Content Writer] Current Project - Plan

Next Step:

 Plan complete!

Next: /writer:execute
(Or use /writer:next to auto-advance)

Phase 3: Execute (Content Generation)

Command: /writer:execute

Goal: Write the content following the plan, applying best practices and brand voice.

Workflow

Step 1: Load Plan & Profile

Load from memory:
• [Content Writer] Current Project - Plan
• [Content Writer] Writer Profile
↓
Missing data? → "Please complete previous phases first"
↓
Data loaded → Continue

Step 2: Voice Calibration

If profile has blog URL:

1. Fetch 1-2 recent articles
2. Analyze sentence patterns
3. Note vocabulary choices
4. Identify personality markers
5. Calibrate generation style

Step 3: Generate Content

Follow the plan outline section by section:

Writing Principles:

1. Use active voice — "We built" not "It was built"
2. Be specific — Use concrete examples, numbers, names
3. Show, don't tell — Use stories and scenarios
4. Vary sentence length — Mix short punchy sentences with longer explanatory ones
5. Use transitions — Connect ideas smoothly
6. Include proof — Data, quotes, case studies
7. Address objections — Anticipate and answer questions
8. Natural keyword use — SEO without stuffing

Anti-AI Principles: Avoid these AI tells:

• Overused words: leverage, seamless, robust, pivotal, delve, realm
• Rule of three everywhere
• Parallel list structures
• Em dash overuse (—)
• Throat-clearing openers ("In today's digital landscape...")
• Generic conclusions ("In conclusion, it's clear that...")
• Vague attributions ("Studies show...")

Platform-Specific Formatting:

Blog Articles:

• H2 every 300-400 words
• Paragraphs: 2-3 sentences max
• Bullet points for lists
• Bold for emphasis
• Include images/visuals (note placement)

LinkedIn Posts:

• Line breaks every 2-3 lines
• Bold for section headers
• 1,400-1,800 characters
• Link in first comment (note this)

Twitter/X:

• Single tweets: 240-280 characters
• Threads: 5-12 tweets, numbered
• One idea per tweet
• No external links in body

Instagram:

• First 125 characters critical (above fold)
• Line breaks and emojis strategic
• 3-5 hashtags
• "Link in bio" for CTA

Facebook:

• 100-250 characters for reach
• Conversational tone
• Link in first comment
• Ask questions

Step 4: Apply Framework

Ensure content follows selected framework structure:

• AIDA: Attention → Interest → Desire → Action
• PAS: Problem → Agitate → Solution
• BAB: Before → After → Bridge
• LEMA: Logic → Explicitness → Memorability → Actionability
• 4-Point: Hook → Effortless → Flow → Polish
• CONVERT: All 7 elements present

Step 5: Insert CTAs

Place CTAs according to platform:

• Blog: Mid-content + end
• LinkedIn: End only
• Twitter: Final tweet
• Instagram: Caption end
• Facebook: Post end

Step 6: Generate Metadata (if applicable)

For blog articles:

• Meta title (50-60 chars)
• Meta description (150-160 chars)
• URL slug
• Image alt text suggestions

Step 7: Present Draft

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Content Draft
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Full content here]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

**Stats:**
• Word count: [count]
• Reading time: [minutes]
• Framework: [framework used]

Ready to verify? (yes/edit)

Step 8: Save Draft State

Save to memory: [Content Writer] Current Project - Draft

Next Step:

 Content generated!

Next: /writer:verify
(Or use /writer:next to auto-advance)

Phase 4: Verify (Quality Check)

Command: /writer:verify

Goal: Run SEO optimization and anti-AI audit to ensure quality.

Workflow

Step 1: Load Draft

Load from memory: [Content Writer] Current Project - Draft
↓
No draft found? → "Please run /writer:execute first"
↓
Draft loaded → Continue

Step 2: SEO Check (claude-seo integration)

Check if claude-seo is available:

Check for claude-seo skill
↓
Available? YES → Run SEO analysis
Available? NO → Skip with warning

If available, analyze:

• Keyword optimization
• Meta tags quality
• Content structure
• Internal/external links
• Readability score
• Technical SEO elements

Present SEO findings:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SEO Analysis (claude-seo)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 Keyword optimization: [score/10]
 Meta tags: [score/10]
 Structure: [score/10]
 Readability: [score/10]

**Recommendations:**
• [Recommendation 1]
• [Recommendation 2]
• [Recommendation 3]

Apply recommendations? (yes/no/manual)

Step 3: Anti-AI Audit (humanizer integration)

Check if humanizer is available:

Check for humanizer skill
↓
Available? YES → Run anti-AI audit
Available? NO → Skip with warning

If available, check for:

• AI vocabulary (leverage, seamless, robust, etc.)
• Parallel structures
• Rule of three overuse
• Em dash frequency
• Generic phrases
• Vague attributions
• Throat-clearing openers

Present humanizer findings:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Anti-AI Audit (humanizer)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Detected AI patterns:
• [Pattern 1]: [count] instances
• [Pattern 2]: [count] instances
• [Pattern 3]: [count] instances

**Suggestions:**
• [Suggestion 1]
• [Suggestion 2]
• [Suggestion 3]

Apply fixes? (yes/no/manual)

Step 4: Manual Review Checklist

Present checklist for user review:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Quality Checklist
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Please review:

**Content Quality:**
 Achieves stated goal
 Follows selected framework
 Maintains brand voice
 Includes specific examples
 No AI writing patterns

**Technical Quality:**
 No spelling/grammar errors
 Proper formatting
 Links work correctly
 Optimized for platform

**Persuasion Quality:**
 Clear value proposition
 Addresses objections
 Includes social proof
 Strong CTA

All good? (yes/needs-work)

Step 5: Apply Fixes (if needed)

If user requests changes:

1. Apply SEO recommendations
2. Fix AI patterns
3. Make manual edits
4. Re-run verification

Step 6: Save Verified State

Save to memory: [Content Writer] Current Project - Verified

Next Step:

 Verification complete!

Next: /writer:ship
(Or use /writer:next to auto-advance)

Phase 5: Ship (Finalize & Deliver)

Command: /writer:ship

Goal: Save content to file, generate metadata, present with publishing notes.

Workflow

Step 1: Load Verified Content

Load from memory: [Content Writer] Current Project - Verified
↓
No verified content? → "Please complete verification first"
↓
Content loaded → Continue

Step 2: Determine Output Location

Smart location detection:

Check if running in Claude Code:
• Check for workspace environment
• Check current working directory
↓
In Claude Code? YES → Save to current directory
In Claude Code? NO → Save to standard output location

Output paths:

• In Claude Code: ./content-writer-output/[type]/[filename].md
• Standard: /mnt/user-data/outputs/content-writer/[type]/[filename].md

Directory structure:

content-writer-output/
├── profile/
│   ├── PROFILE.md
│   ├── PRODUCTS.md
│   ├── CTAS.md
│   └── CASE-STUDIES.md
├── blog/
│   ├── 001-article-title.md
│   └── ...
├── linkedin/
│   ├── 001-post-title.md
│   └── ...
├── facebook/
├── instagram/
├── twitter/
├── seo/
├── packages/
│   ├── 001-package-name/
│   │   ├── blog.md
│   │   ├── linkedin.md
│   │   ├── newsletter.md
│   │   └── PACKAGE.md
│   └── ...
└── research/

Step 3: Generate Filename

Format: {number}-{slug}.md

Example: 001-why-saas-onboarding-fails.md

Number: Auto-increment based on existing files in directory Slug: Generated from title (lowercase, hyphens, no special chars)

Step 4: Create Metadata

Add frontmatter to markdown file:

---