Content Generation

Overview

Generate professional content including images, diagrams, documents, and summaries using AI-powered tools.

Quick Decision Tree

What do you need?
│
├── Generate images
│   └── references/images.md
│   └── Script: scripts/generate_images.py
│
├── Create flowchart/diagram
│   └── references/flowchart.md
│   └── Script: scripts/generate_flowchart.py
│
├── Create Google Doc
│   └── references/document.md
│   └── Script: scripts/generate_document.py
│
├── Generate client proposal
│   └── references/proposal.md
│   └── Script: scripts/generate_proposal.py
│
├── Convert Markdown to PDF
│   └── references/pdf.md
│   └── Script: scripts/md_to_pdf.py
│
└── Summarize content
    └── references/summarize.md
    └── Script: scripts/summarize_content.py

Environment Setup

# Required in .env
FAL_API_KEY=fal_xxxx              # For image generation
OPENROUTER_API_KEY=sk-or-v1-xxx   # For AI text generation

Get API keys:

• •fal.ai: https://fal.ai/dashboard/keys
• •OpenRouter: https://openrouter.ai/keys

Common Usage

Generate Images

# Nano Banana Pro (best quality)
python scripts/generate_images.py "Professional product photo of smartwatch" --model nano-banana-pro

# FLUX-2 (fast, cheap)
python scripts/generate_images.py "Vibrant lifestyle photo" --model flux-2 --size landscape_4_3

Create Flowchart

python scripts/generate_flowchart.py "User login: enter email, validate, check password, if correct go to dashboard"

Generate Document

python scripts/generate_document.py --input content.json --title "Q4 Report"

Generate Proposal

python scripts/generate_proposal.py --transcript-file meeting.txt --client "Acme Corp"

Cost Estimates

Security Notes

Credential Handling

• •Store FAL_API_KEY in .env file (never commit to git)
• •Store OPENROUTER_API_KEY in .env file (never commit to git)
• •Regenerate keys from respective dashboards if compromised
• •Never log or print API keys in script output

Data Privacy

• •Text prompts sent to fal.ai and OpenRouter servers
• •Generated images stored locally in .tmp/ directory
• •AI services may log prompts for service improvement
• •Avoid including sensitive/confidential data in prompts
• •Generated documents may be uploaded to Google Drive

Access Scopes

• •FAL_API_KEY - Full access to image generation models
• •OPENROUTER_API_KEY - Access to configured AI models
• •Google OAuth - Required for Google Docs creation (see google-workspace skill)

Compliance Considerations

• •AI Disclosure: Consider disclosing AI-generated content where required
• •Image Rights: Generated images subject to fal.ai terms of use
• •Copyright: AI-generated content copyright varies by jurisdiction
• •Brand Consistency: Review AI outputs against brand guidelines
• •Sensitive Content: AI image generators have content policies
• •Client Proposals: Verify accuracy before sending to clients
• •Attribution: Some contexts require AI generation disclosure

Troubleshooting

Common Issues

Issue: Image generation failed

Symptoms: fal.ai returns error or no image generated Cause: Invalid prompt, model unavailable, or API issue Solution:

• •Check prompt for policy violations (explicit content, etc.)
• •Verify model ID is correct and available
• •Try a simpler prompt to test API connectivity
• •Check fal.ai status page for outages

Issue: Content policy violation

Symptoms: "Content policy violation" or similar safety error Cause: Prompt contains flagged terms or concepts Solution:

• •Remove explicit, violent, or harmful content from prompt
• •Rephrase ambiguous terms that might trigger filters
• •Review fal.ai content policy guidelines
• •Use more general/professional language

Issue: Google Doc not created

Symptoms: Script completes but no document appears in Drive Cause: OAuth issue, folder permissions, or API error Solution:

• •Verify Google OAuth is working (see google-workspace skill)
• •Check target folder exists and is accessible
• •Delete mycreds.txt and re-authenticate
• •Look for error messages in script output

Issue: Flowchart syntax error

Symptoms: Mermaid diagram fails to render Cause: Invalid Mermaid syntax in generated diagram Solution:

• •Review generated Mermaid code for syntax errors
• •Simplify complex flows into smaller diagrams
• •Test diagram at https://mermaid.live/
• •Ensure special characters are properly escaped

Issue: PDF conversion fails

Symptoms: Error during markdown to PDF conversion Cause: Missing dependencies or invalid markdown Solution:

• •Ensure required PDF tools are installed (weasyprint, etc.)
• •Check markdown syntax is valid
• •Verify font files exist if custom fonts specified
• •Try with simpler markdown to isolate issue

Issue: OpenRouter API error

Symptoms: Text generation fails with API error Cause: Invalid API key, model unavailable, or rate limit Solution:

• •Verify OPENROUTER_API_KEY is set correctly
• •Check model availability at OpenRouter dashboard
• •Try a different model if current one is unavailable
• •Review rate limit status and add delays if needed

Resources

• •references/images.md - fal.ai image generation
• •references/flowchart.md - Mermaid diagram generation
• •references/document.md - Google Docs creation
• •references/proposal.md - Client proposal generation
• •references/pdf.md - Markdown to PDF conversion
• •references/summarize.md - Content summarization

Integration Patterns

Generate and Save

Skills: content-generation → google-workspace Use case: Create documents and store in Drive Flow:

1. •Generate content (proposal, report, summary)
2. •Format as Google Doc or PDF
3. •Upload to appropriate Drive folder via google-workspace

Proposal to CRM

Skills: content-generation → attio-crm Use case: Link generated proposals to deal records Flow:

1. •Generate client proposal from meeting transcript
2. •Upload proposal to Google Drive
3. •Add note to Attio CRM company record with proposal link

Images to Video

Skills: content-generation → video-production Use case: Create title slides for video courses Flow:

1. •Generate branded title slide images for each lesson
2. •Export images to video-compatible format
3. •Use video-production to stitch with lesson videos