AI Content Generation Guide

Use AI to generate high-quality content efficiently for the AI Agentification Platform.

Quick Start (5 Minutes)

Step 1: Choose Your AI Tool

Compatible with:

• ChatGPT (4.0+) - Best for structured content
• Claude (3+ Opus/Sonnet) - Great for technical accuracy
• Gemini (Pro) - Good for creative content

Step 2: Use This Prompt Template

Generate a complete article for my AI education platform in JSON format.

TOPIC: [YOUR TOPIC HERE]
CONTENT TYPE: [blog/tutorial/lesson/tip/case_study]
AUDIENCE: [beginner/intermediate/advanced]
LENGTH: [1500-2000 words]

Provide complete JSON with these fields:
- title (max 60 chars, SEO-optimized)
- slug (URL-friendly)
- subtitle (one compelling sentence)
- excerpt (150-200 chars)
- content_type
- access_level (suggest: public/registered/premium)
- difficulty_level
- category (from: AI Agents, Automation, Tutorials, Case Studies, Best Practices)
- tags (5-7 relevant tags as array)
- featured_image_description (I'll source image)
- meta_title (max 60 chars)
- meta_description (max 160 chars)
- content (TipTap JSON format with headings, paragraphs, code blocks, lists)

Content should include:
- Hook in first paragraph
- 3-5 main sections with H2 headings
- Practical examples
- Code examples (if tutorial)
- Key takeaways
- Call-to-action

Make it professional, practical, and SEO-optimized.

Step 3: Generate and Use

1. Paste prompt into AI tool
2. Customize topic and requirements
3. Wait for AI to generate JSON
4. Review and test code examples
5. Copy to content editor or import JSON

Content Type-Specific Prompts

Blog Posts (1200-1500 words)

Create a blog post about [TOPIC] that:
- Has compelling narrative structure
- Includes real-world examples
- Addresses common pain points
- Ends with actionable takeaways
- Is 1200-1500 words
- Optimized for SEO with keywords: [LIST KEYWORDS]
- Accessible to [beginner/intermediate/advanced] readers

Tutorials (1500-2500 words)

Create a step-by-step tutorial about [TOPIC]:
- Clear learning objectives
- Prerequisites section
- Step-by-step instructions
- Code examples with explanations (Python/JavaScript)
- Expected outputs for each step
- Common troubleshooting section
- "What's Next" section
- 1500-2500 words

Quick Tips (500-800 words)

Create a quick tip article about [TOPIC]:
- Gets straight to the point
- 3-5 actionable tips
- Examples for each tip
- Concise (500-800 words)
- Immediate practical value
- Format as numbered list with explanations

Case Studies (1500-2000 words)

Create a case study about [COMPANY/PROJECT]:
- Background/Challenge section
- Solution approach
- Implementation details
- Results with specific metrics
- Lessons learned
- Key takeaways
- 1500-2000 words
- Data-driven and credible

Advanced Prompt Customization

Be Specific About Tone

Tone: [Professional/Casual/Technical/Friendly]
Style: [Educational/Authoritative/Conversational]
Avoid: [Jargon without explanation/Overly technical terms]
Include: [Real-world examples/Analogies/Step-by-step instructions]

Request Specific Elements

Must include:
- [ ] Attention-grabbing hook in first paragraph
- [ ] At least 2 code examples (Python)
- [ ] A comparison table
- [ ] "Key Takeaways" box with 5 bullet points
- [ ] Clear call-to-action at end
- [ ] Mermaid diagram showing workflow

SEO Optimization

Primary keyword: "[MAIN KEYWORD]"
Secondary keywords: "[KEYWORD 1]", "[KEYWORD 2]", "[KEYWORD 3]"

Include keywords naturally in:
- Title
- First paragraph
- At least 2 H2 headings
- Meta description
- Throughout content (2-3% density)

Batch Generation

Generate multiple articles at once:

Generate 5 blog posts for my AI education platform:

1. "Introduction to AI Agents for Beginners" (beginner, public, blog, 1200 words)
2. "Top 10 Use Cases for AI Agents" (beginner, public, blog, 1500 words)
3. "Building Your First Chatbot with Python" (intermediate, registered, tutorial, 2000 words)
4. "RAG vs Fine-tuning Comparison" (intermediate, public, blog, 1500 words)
5. "Scaling AI Agents in Production" (advanced, premium, tutorial, 2500 words)

For each, provide complete JSON with all fields.
Return as array of JSON objects.

TipTap JSON Structure

AI must generate content in this format:

Basic Elements

{
  "type": "doc",
  "content": [
    {
      "type": "heading",
      "attrs": { "level": 2 },
      "content": [{ "type": "text", "text": "Section Title" }]
    },
    {
      "type": "paragraph",
      "content": [
        { "type": "text", "text": "Regular text " },
        {
          "type": "text",
          "marks": [{ "type": "bold" }],
          "text": "bold text"
        }
      ]
    },
    {
      "type": "bulletList",
      "content": [
        {
          "type": "listItem",
          "content": [
            {
              "type": "paragraph",
              "content": [{ "type": "text", "text": "List item" }]
            }
          ]
        }
      ]
    },
    {
      "type": "codeBlock",
      "attrs": { "language": "python" },
      "content": [
        { "type": "text", "text": "print('Hello World')" }
      ]
    }
  ]
}

Important: Use camelCase

• ✅ bulletList (correct)
• ❌ bullet_list (wrong)
• ✅ codeBlock (correct)
• ❌ code_block (wrong)

Quality Control

Always Review AI Output

Technical Accuracy:

• All facts verified
• Code examples tested
• Links work
• No outdated information

SEO:

• Title < 60 chars
• Meta description < 160 chars
• Keywords included naturally
• Headers use keywords
• Alt text for images (if described)

Quality:

• Original insights added
• Matches brand voice
• No AI "tells" (overly formal, generic)
• Provides real value
• Actionable takeaways

Formatting:

• Proper heading hierarchy (H2, H3)
• Short paragraphs (2-4 sentences)
• Bullet points for lists
• Code blocks formatted
• Images described (for manual addition)

Pro Tips

1. Be Specific in Prompts

❌ Bad: "Write about AI agents" ✅ Good: "Write a beginner tutorial about building a Slack bot that answers FAQs using LangChain and OpenAI"

2. Provide Context

Our audience is:
- Tech-savvy business owners
- Looking for ROI and practical results
- Not developers (explain code simply)
- Interested in automation benefits

3. Request Examples

Include:
- 2-3 code examples with explanations
- Real-world use case
- Before/after comparison
- ROI calculation example

4. Iterate and Refine

If output isn't perfect:

Please revise the introduction to be more engaging and include a specific example of [TOPIC] in action.

The code example needs to be more beginner-friendly. Add comments explaining each line.

Common Issues and Solutions

AI generates wrong format

Problem: Output is not valid TipTap JSON

Solution: Include structure example in prompt

Use this exact TipTap JSON structure:
{
  "type": "doc",
  "content": [
    {"type": "heading", "attrs": {"level": 2}, ...},
    {"type": "paragraph", ...}
  ]
}

Content too generic

Problem: Output lacks specificity

Solution: Add constraints and examples

Include:
- Specific tool names (LangChain, OpenAI GPT-4)
- Real company examples
- Actual metrics (e.g., "reduced support costs by 60%")
- Code that actually works

Code doesn't work

Problem: Code examples have errors

Solution: Always test AI-generated code

• Copy code to IDE
• Run and test
• Fix any errors
• Update in content before publishing

Wrong tone

Problem: Too formal or too casual

Solution: Specify tone explicitly

Tone: Professional but approachable, like explaining to a colleague
Avoid: Corporate jargon, overly casual slang
Example style: "Let's build this together" not "One must construct"

Time Savings

Manual vs AI-Assisted:

• Blog post: 4-6 hours → 1-2 hours (generate + review)
• Tutorial: 8-12 hours → 3-4 hours (generate + test code)
• Case study: 6-10 hours → 2-3 hours (generate + customize)

Savings: 50-70% time reduction

Workflow Recommendations

Daily Content Creation

1. Morning: Generate 2-3 article drafts with AI
2. Afternoon: Review, fact-check, customize
3. Evening: Add images, optimize SEO, publish

Weekly Planning

1. Plan content calendar (topics, types)
2. Generate all articles at once (batch)
3. Review and customize throughout week
4. Schedule publications

Monthly Strategy

1. Analyze top-performing content
2. Generate similar topics with AI
3. Update old content with AI assistance
4. Create content series

Additional Resources

• Content Management Guide - Publishing workflow
• Schema Reference - Field specifications
• TipTap Documentation - Editor features
• ChatGPT - Content generation
• Claude - Technical content

Last Updated: December 2025