Skip to main content

​
Overview

The Create Collective is Genie’s content and communication department - a shape-shifting team that handles documentation, marketing, announcements, and all human-world work.

Shape-Shifting Philosophy: Create Becomes What You Need

Unlike Code Collective’s specialized agents, Create embraces flexibility:
  • Adaptive expertise: Agents shape-shift based on your needs
  • Context-aware: Understands audience and purpose
  • Multi-platform: Works across docs, blogs, social media, email
  • Meta-creation: Can even create new agents, spells, and workflows

​
The Shape-Shifting Difference

​
Code Collective: Specialization

implementor → Feature implementation (specific role)
tests → Testing (specific role)
git → Git operations (specific role)

​
Create Collective: Transformation

writer → Technical docs → Blog post → Tutorial → Marketing copy
         ^                ^            ^          ^
         |                |            |          |
    Same agent, different forms based on context

​
9 Core Agents

​
Content Creation Agents

Purpose: Research information and gather knowledgeShape-Shifts Into:
  • Technical researcher
  • Market researcher
  • Competitive analyst
  • Trend analyst
  • User researcher
When to Use: Need information, market research, competitive analysis
# Becomes technical researcher
genie summon researcher "Research modern authentication patterns"

# Becomes market researcher
genie summon researcher "Analyze competitor pricing strategies"

# Becomes trend analyst
genie summon researcher "Research emerging AI trends for 2025"
Output Examples:
  • Research reports
  • Competitive analyses
  • Trend summaries
  • Best practice guides
Purpose: Create written content for any purposeShape-Shifts Into:
  • Technical writer
  • Blog writer
  • Tutorial creator
  • Marketing copywriter
  • Email writer
  • Social media writer
  • Documentation writer
When to Use: Any content creation task
# Becomes technical writer
genie summon writer "Document authentication API endpoints"

# Becomes blog writer
genie summon writer "Write blog post about v2.0 release"

# Becomes marketing copywriter
genie summon writer "Create landing page copy for new product"

# Becomes tutorial creator
genie summon writer "Create step-by-step tutorial for OAuth setup"
Output Examples:
  • API documentation
  • Blog posts
  • Landing pages
  • Tutorials
  • User guides
Purpose: Refine and polish content to excellenceShape-Shifts Into:
  • Technical editor
  • Copy editor
  • Content strategist
  • Style guide enforcer
  • Quality validator
When to Use: Refining content, ensuring quality, maintaining consistency
# Becomes technical editor
genie summon editor "Review and refine API documentation"

# Becomes copy editor
genie summon editor "Polish blog post for clarity and engagement"

# Becomes style guide enforcer
genie summon editor "Ensure content follows brand voice guidelines"
Focuses On:
  • Clarity and conciseness
  • Grammar and style
  • Consistency
  • Audience appropriateness
  • Engagement

​
Specialized Content Agents

Purpose: Create beautiful, comprehensive release notesShape-Shifts Into:
  • Technical release notes
  • User-friendly changelogs
  • Feature announcements
  • Migration guides
When to Use: Releases, version updates, feature launches
# Create release notes from commits
genie summon release-notes "Generate release notes for v2.0.0"

# Create user-friendly changelog
genie summon release-notes "Create changelog highlighting user benefits"
Output Format:
# 🎉 Version 2.0.0 Release

## ✨ New Features
- **OAuth2 Authentication**: Secure login with major providers
- **Real-time Notifications**: WebSocket-based updates

## 🚀 Improvements
- 40% faster API response times
- Reduced bundle size by 30%

## 🐛 Bug Fixes
- Fixed memory leak in WebSocket handler
- Resolved race condition in auth flow

## 📚 Documentation
- Complete API reference
- Migration guide from v1.x

## 🙏 Thank You
Special thanks to our contributors...
Purpose: Create announcements for multiple platformsShape-Shifts Into:
  • Blog announcements
  • Twitter threads
  • Discord messages
  • Email newsletters
  • LinkedIn posts
  • Reddit posts
When to Use: Feature launches, releases, major updates
# Create multi-platform announcement
genie summon announcements "Announce v2.0 release across all platforms"
Output Example:
## Blog Post
[Long-form announcement with details]

## Twitter Thread
1/ 🎉 We're thrilled to announce Genie v2.0!

2/ ✨ New Features:
- OAuth2 authentication
- Real-time notifications
- 40% faster performance

3/ 🚀 Get started: npm install automagik-genie@latest

## Discord Message
@everyone 🎉 Genie v2.0 is here!

What's new:
- OAuth2 authentication
- Real-time notifications
- Major performance improvements

Docs: https://docs.namastex.io/genie

## Email Newsletter
[Professional email format with styling]
Purpose: Keep documentation in sync with code versionsShape-Shifts Into:
  • Version updater
  • Dependency tracker
  • Changelog maintainer
  • Migration guide creator
When to Use: Version bumps, dependency updates, API changes
# Sync docs with new version
genie summon docs-sync "Update all docs for v2.0.0"

# Check version consistency
genie summon docs-sync "Audit version numbers across docs"
Handles:
  • Version number updates
  • API version changes
  • Dependency version updates
  • Example code updates
  • Link updates

​
Meta-Creation Agents

Purpose: Create new specialized agentsWhen to Use: Need a new specialized agent
# Create new agent for custom collective
genie summon agent-creator "Create a financial analyst agent"

# Output: agents/financial-analyst.md
Creates:
  • Agent definition
  • Capabilities
  • Specialties
  • Usage examples
Purpose: Create new behavioral protocols (spells)When to Use: Need new behavioral guidelines
# Create new spell
genie summon spell-creator "Create spell for financial reporting standards"

# Output: spells/financial-reporting.md
Creates:
  • Protocol definition
  • Decision rules
  • Quality criteria
  • Usage guidelines
Purpose: Create new repeatable workflowsWhen to Use: Need new process automation
# Create new workflow
genie summon workflow-creator "Create workflow for quarterly reports"

# Output: workflows/quarterly-report.md
Creates:
  • Workflow definition
  • Step sequence
  • Agent coordination
  • Validation gates

​
Create-Specific Spells

The Create Collective includes 10 behavioral protocols:
  • Excellence Spells
  • Platform Spells
  • Process Spells
content-excellence.md
  • Quality standards
  • Engagement criteria
  • Value delivery
clarity-focus.md
  • Clear communication
  • Concise writing
  • Audience awareness
empathy-driven.md
  • User-first thinking
  • Emotional intelligence
  • Accessibility focus

​
Workflows

The Create Collective has three meta-creation workflows:

​
1. Agent Generation Workflow

Purpose: Create new specialized agents
1

Define Need

Identify the gap in capabilities
genie wish "Need agent for financial analysis"
2

Generate Agent

Create agent definition
genie summon agent-creator "Financial analyst agent"
3

Review & Refine

Validate agent capabilities and adjust
4

Deploy

Add to appropriate collective
genie collective add-agent finance analyst

​
2. Skill Generation Workflow

Purpose: Create new skills and capabilities
1

Identify Skill Gap

What capability is missing?
2

Define Skill

Specify skill requirements and behaviors
3

Implement

Create skill definition and protocols
4

Test

Validate skill works as expected

​
3. Workflow Generation Workflow

Purpose: Create new repeatable processes
1

Map Process

Document current manual process
2

Identify Automation

Find automation opportunities
3

Design Workflow

Create workflow structure with agent coordination
4

Validate

Test workflow end-to-end
5

Deploy

Make available for use

​
Creative Council (Advisory Team)

The Creative Council is an advisory team for content strategy:

Creative Council Composition

Members:
  • researcher - Data and insights perspective
  • writer - Content quality and engagement
  • editor - Clarity and excellence
  • strategist - Long-term content strategy
  • audience-expert - User perspective
When to Convene:
  • Major content initiatives
  • Brand voice decisions
  • Content strategy planning
  • Platform expansion
  • Messaging alignment
# Convene Creative Council for strategy
genie council creative "Should we focus on technical blogs or tutorials?"

# Council provides perspectives:
# - researcher: "Audience data shows 60% prefer tutorials..."
# - writer: "Tutorials have 3x engagement of blogs..."
# - editor: "Quality tutorials require more resources..."
# - strategist: "Start with tutorials, add blogs later..."
# - audience-expert: "Users want step-by-step guides..."

​
Use Cases

​
Documentation Creation

  • API Documentation
  • Tutorial Creation
  • User Guide
# Research API patterns
genie summon researcher "Research API documentation best practices"

# Write initial docs
genie summon writer "Document authentication API endpoints"

# Refine and polish
genie summon editor "Review and refine API docs for clarity"

# Create examples
genie summon writer "Add code examples for all API endpoints"
Output: Complete API documentation with examples

​
Marketing Content

  • Product Launch
  • Blog Post
  • Landing Page
# Research market
genie summon researcher "Analyze competitor positioning"

# Create messaging
genie summon writer "Create product launch messaging"

# Multi-platform announcement
genie summon announcements "Create launch content for all platforms"

# Review strategy
genie council creative "Review launch strategy and messaging"

​
Release Management

  • Release Notes
  • Announcements
  • Documentation Update
# Generate release notes from commits
genie summon release-notes "Create v2.0.0 release notes"

# Review and enhance
genie summon editor "Enhance release notes with user benefits"

# Create migration guide if needed
genie summon writer "Create v1.x to v2.0 migration guide"

​
Meta-Creation Examples

​
Creating a New Agent

# Use agent-creator to generate new agent
genie summon agent-creator "Create SEO specialist agent"
Generated Agent (agents/seo-specialist.md): 
# SEO Specialist Agent

## Purpose
Optimize content for search engine visibility and ranking

## Specialties
- Keyword research and optimization
- Meta description creation
- Content structure for SEO
- Internal linking strategy
- Technical SEO analysis

## Shape-Shifts Into
- On-page SEO optimizer
- Keyword researcher
- Content strategist
- Technical SEO auditor

## Usage Examples
- Optimize blog posts for target keywords
- Create SEO-friendly page structures
- Audit content for SEO issues
- Research keyword opportunities

## Behavioral Protocols
- Focus on user intent, not just keywords
- Balance SEO with readability
- Follow search engine guidelines
- Measure and iterate based on data

​
Creating a New Spell

# Use spell-creator to generate new spell
genie summon spell-creator "Create spell for SEO-optimized content"
Generated Spell (spells/seo-optimization.md): 
# SEO Optimization Spell

## Purpose
Guide content creation with SEO best practices

## Protocol
1. Research target keywords
2. Analyze search intent
3. Create compelling title (50-60 chars)
4. Write meta description (150-160 chars)
5. Structure content with headers (H1, H2, H3)
6. Include keywords naturally (2-3% density)
7. Add internal and external links
8. Optimize images with alt text
9. Ensure mobile-friendly formatting
10. Validate readability (Flesch score > 60)

## Decision Rules
- Primary keyword in title and first paragraph
- Use semantic variations, not keyword stuffing
- Prioritize user experience over search engines
- Balance information density with readability

## Quality Criteria
- Title is compelling and includes keyword
- Meta description entices clicks
- Content answers user questions
- Headers create clear structure
- Links add value, not just SEO

​
Creating a New Workflow

# Use workflow-creator to generate new workflow
genie summon workflow-creator "Create SEO content workflow"
Generated Workflow (workflows/seo-content.md): 
# SEO Content Creation Workflow

## Purpose
Create SEO-optimized content systematically

## Steps

### 1. Keyword Research
**Agent**: researcher (as keyword researcher)
**Task**: Identify target keywords and search intent
**Output**: Keyword list with search volume and intent

### 2. Content Planning
**Agent**: writer (as content strategist)
**Task**: Plan content structure and outline
**Output**: Detailed content outline with keyword placement

### 3. Content Creation
**Agent**: writer (as SEO writer)
**Task**: Write content following SEO spell
**Output**: Draft content optimized for keywords

### 4. SEO Optimization
**Agent**: seo-specialist
**Task**: Optimize content for search engines
**Output**: SEO-optimized content

### 5. Quality Review
**Agent**: editor
**Task**: Ensure quality while maintaining SEO
**Output**: Polished, SEO-optimized content

### 6. Publication
**Agent**: writer
**Task**: Format and publish content
**Output**: Published content

## Validation Gates
- Keywords naturally integrated (not stuffed)
- Content provides real value to readers
- Technical SEO requirements met
- Readability score meets standards

​
Collaboration with Code Collective

Create and Code work together seamlessly:

​
Example: Feature Launch

1

Code Builds

Code Collective implements feature:
  • implementor writes code
  • tests validates
  • documenter adds inline docs
2

Create Documents

Create Collective documents feature:
  • researcher researches best practices
  • writer creates user documentation
  • editor refines for clarity
3

Create Announces

Create Collective announces launch:
  • release-notes generates beautiful notes
  • announcements creates multi-platform content
  • Blog, social media, email, Discord
4

Continuous Updates

Create Collective maintains:
  • docs-sync keeps versions current
  • editor updates based on feedback
  • writer creates additional tutorials

​
Best Practices

Let agents adapt to context:Good:
# Let writer become what you need
genie summon writer "Create OAuth2 tutorial for beginners"
# Writer automatically becomes tutorial creator
Not Necessary:
# Don't over-specify the form
genie summon tutorial-creator "Create OAuth2 tutorial"
# Writer already knows to be a tutorial creator
Convene for strategy, not tactics:Good Council Use:
genie council creative "Should we focus on technical or business content?"
Tactical (Don’t Need Council):
genie summon editor "Review this blog post"
# Editor can handle this alone
Create custom capabilities when needed:
# Need something Create doesn't have?
genie summon agent-creator "Create video script writer agent"
genie summon spell-creator "Create spell for video content"
genie summon workflow-creator "Create video production workflow"

# Now you have custom capabilities!
Always sync docs with code versions:
# After version bump
genie summon docs-sync "Sync all docs for v2.0.0"

# Before release
genie summon docs-sync "Audit version consistency"

​
Next Steps

Code Collective

Learn about technical development agents

Custom Collectives

Build your own domain-specific collectives

Workflows

Deep dive into workflow orchestration

Quick Start

Get started with Genie