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

Tool	Cost
Nano Banana Pro 1K	$0.15/image
Nano Banana Pro 4K	$0.30/image
FLUX-2	$0.012/megapixel
Flowchart	~$0.005/diagram
Proposal	~$0.10/doc

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:

Generate content (proposal, report, summary)
Format as Google Doc or PDF
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:

Generate client proposal from meeting transcript
Upload proposal to Google Drive
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:

Generate branded title slide images for each lesson
Export images to video-compatible format
Use video-production to stitch with lesson videos