# 10X Content Expert

A comprehensive Claude Code skills plugin for **AI-powered content creation**. Creates emails, social media content, presentations, blogs, and more - all aligned with your brand voice and informed by your reference materials.

## Quick Setup (One Command)

**Before using these skills, run this setup command:**

```bash
python setup.py
```

This will:
- Install all required Python packages
- Create necessary folders
- Set up the environment

**Prerequisites:**
- Python 3.9 or higher installed
- pip (Python package manager)

---

## Features

### Content Creation
- **Emails** - Cold emails, nurture sequences, newsletters, promotions
- **Social Media** - LinkedIn, Twitter, Instagram posts and threads
- **Presentations** - Pitch decks, sales presentations, training content
- **Blogs & Articles** - How-to guides, thought leadership, case studies
- **Hooks & CTAs** - Headlines, subject lines, calls-to-action

### Reference-Powered Intelligence
- **Transcript Analysis** - Extract insights from video/audio transcripts
- **Brand Voice Learning** - Maintains consistent voice across all content
- **Example Learning** - Learns from your best-performing content
- **Theme Extraction** - Identifies key themes across your materials

### Local File Editing
- **PDF** - Read, modify, merge, split, extract text
- **PowerPoint** - Edit slides, text, images, notes
- **Word** - Modify documents, tables, formatting
- **Excel** - Update cells, formulas, sheets

### Canva Integration (Optional)
When explicitly requested, create designs using Canva API:
- **Social Graphics** - Instagram posts, LinkedIn banners, Twitter headers
- **Presentations** - Pitch decks, sales presentations in Canva
- **Videos** - Short-form video content
- **Export** - Download designs in any format (PDF, PNG, PPTX, etc.)

---

## Installation

### Step 1: Download/Clone

Place this folder in your projects directory.

### Step 2: Run Setup

```bash
cd 10x-Content-Expert
python setup.py
```

### Step 3: Add Your References (Optional but Recommended)

Add your content to the `references/` folder:
- Transcripts from training videos, webinars, podcasts
- Examples of your best emails, social posts, blogs
- Brand voice guidelines

### Step 4: Start Claude Code

```bash
claude
```

Use `/content` to access all content creation capabilities!

---

## Usage Examples

### Quick Content Creation

```
"Write a LinkedIn post about content marketing"
"Create an email sequence for my new course"
"Generate 10 headlines for my blog post"
"Write a pitch deck outline for my startup"
```

### Reference-Based Content

```
"Analyze my transcripts and extract key insights"
"Create social posts from my webinar transcript"
"Learn my brand voice from these examples"
```

### Multi-Format Projects

```
"I need content for my product launch - emails, social, and presentation"
"Repurpose my blog post into social media content"
"Create a content calendar from my training materials"
```

### Local File Editing

```
"Edit my presentation.pptx and update the slides"
"Modify my document.docx - replace company name"
"Update cell B5 in my spreadsheet.xlsx"
```

---

## How It Works

### 3-Mode Workflow

1. **PLAN** - Analyze request, review references, create strategy
2. **CLARIFY** - Ask questions, understand requirements
3. **IMPLEMENT** - Create content using appropriate frameworks

### Reference Learning

```
Your References (references/)  →  Analysis  →  Personalized Content
   - Transcripts                    - Themes     - On-brand
   - Examples                       - Quotes     - Consistent voice
   - Brand voice                    - Style      - Informed by your content
```

---

## Project Structure

```
10x-Content-Expert/
├── .claude/                    # Claude Code integration
│   ├── skills/                 # 27 specialized skills
│   │   ├── content-manager     # Main content orchestrator
│   │   ├── content-analyzer    # Reference analysis
│   │   ├── email-copywriter    # Email content
│   │   ├── social-media-writer # Social media content
│   │   ├── presentation-content# PPT content
│   │   ├── blog-article-writer # Long-form content
│   │   ├── hook-generator      # Headlines & CTAs
│   │   ├── nurture-sequence    # Email sequences
│   │   ├── content-repurposer  # Format transformation
│   │   ├── brand-voice-manager # Voice consistency
│   │   ├── content-frameworks  # Copywriting reference
│   │   ├── local-*             # File editing skills
│   │   └── canva-*             # Canva API skills
│   ├── agents/                 # Planning & execution
│   └── commands/               # /content and /canva commands
│
├── scripts/                    # Python utilities
│   ├── content/                # Content analysis scripts
│   │   ├── analyze_transcript.py
│   │   ├── extract_themes.py
│   │   ├── find_quotes.py
│   │   └── analyze_brand_voice.py
│   └── local/                  # File editing utilities
│
├── references/                 # YOUR REFERENCE MATERIALS
│   ├── transcripts/            # Video/audio transcripts
│   ├── examples/               # High-performing content
│   ├── brand-voice/            # Brand guidelines
│   └── templates/              # Content templates
│
├── input/                      # Files to edit
├── output/                     # Generated content & results
│
├── setup.py                    # ONE-TIME SETUP SCRIPT
├── requirements.txt            # Python dependencies
└── README.md                   # This file
```

---

## Skills Available

### Content Creation (11 skills)

| Skill | Description |
|-------|-------------|
| `content-manager` | Main orchestrator, routes to specialists |
| `content-analyzer` | Analyzes transcripts, extracts insights |
| `email-copywriter` | All types of email content |
| `social-media-writer` | LinkedIn, Twitter, Instagram content |
| `presentation-content` | PPT, pitch decks, training |
| `blog-article-writer` | Long-form content, guides, articles |
| `hook-generator` | Headlines, subject lines, CTAs |
| `nurture-sequence` | Email drip campaigns, sequences |
| `content-repurposer` | Transform content across formats |
| `brand-voice-manager` | Maintain voice consistency |
| `content-frameworks` | Copywriting framework reference |

### Local File Editing (5 skills)

| Skill | Description |
|-------|-------------|
| `local-file-manager` | Routes to correct editor |
| `local-pdf-editor` | PDF manipulation |
| `local-pptx-editor` | PowerPoint editing |
| `local-docx-editor` | Word document editing |
| `local-xlsx-editor` | Excel spreadsheet editing |

### Canva API Skills (11 skills)

| Skill | Description |
|-------|-------------|
| `canva-manager` | Main Canva orchestrator |
| `canva-explorer` | Browse designs, folders, assets |
| `canva-export` | Export designs to any format |
| `canva-image-editor` | Create/edit social graphics |
| `canva-presentation` | Create Canva presentations |
| `canva-video` | Create video content |
| `canva-folder-organizer` | Organize Canva projects |
| `canva-asset-manager` | Upload and manage assets |
| `canva-brand-kit` | Manage brand consistency |
| `canva-content-generator` | Generate design content |
| `canva-design-terminology` | Canva reference guide |

---

## The /content Command

Quick access to all content capabilities:

```
/content email      - Create email content
/content social     - Create social media posts
/content ppt        - Create presentation content
/content blog       - Create blog/article content
/content hooks      - Generate headlines & CTAs
/content sequence   - Create email sequences
/content repurpose  - Transform content formats
/content analyze    - Analyze your references
/content voice      - Manage brand voice
/content plan       - Plan a content project
```

---

## Adding Your References

### Transcripts

Add transcripts from your videos, webinars, or podcasts:

```
references/transcripts/
├── training/
│   └── my_training_video.txt
├── webinars/
│   └── product_launch_webinar.txt
└── podcasts/
    └── interview_episode_1.txt
```

### Content Examples

Add your best-performing content:

```
references/examples/
├── emails/
│   └── best_welcome_email.txt
├── social/
│   ├── linkedin/
│   │   └── viral_post.txt
│   └── twitter/
│       └── popular_thread.txt
└── blogs/
    └── top_article.md
```

### Brand Voice

Document your brand guidelines:

```
references/brand-voice/
├── tone-guide.md         # Voice & tone documentation
├── messaging-framework.md # Core messages
├── keywords.txt          # Power words to use
└── avoid-list.txt        # Words to avoid
```

---

## Canva API Setup (Optional)

If you want to use Canva design features:

### Step 1: Get Canva API Credentials

1. Go to [Canva Developer Portal](https://www.canva.com/developers/)
2. Create a new app
3. Note your Client ID and Client Secret

### Step 2: Configure Environment

```bash
# Copy the template
cp .env.example .env

# Edit .env and add your credentials
CANVA_CLIENT_ID=your_client_id_here
CANVA_CLIENT_SECRET=your_client_secret_here
```

### Step 3: Run OAuth Flow

```bash
python scripts/oauth_flow.py
```

This opens a browser for authorization. After approving, your tokens are saved automatically.

### Step 4: Test Connection

```bash
python scripts/auth_check.py
```

### Using Canva

```
/canva explore          - Browse your designs
/canva export [name]    - Export a design
/canva upload [file]    - Upload an asset
```

---

## Troubleshooting

### Setup Issues

```bash
# If setup.py fails, try manually:
pip install -r requirements.txt
```

### Missing Dependencies

```bash
# Reinstall all dependencies:
pip install --upgrade -r requirements.txt
```

### Skills Not Loading

1. Ensure you're in the correct directory
2. Restart Claude Code
3. Check `.claude/skills/` folder exists

### Canva API Issues

```bash
# Refresh access token
python scripts/oauth_flow.py

# Check if token is valid
python scripts/auth_check.py
```

---

## Tips for Best Results

1. **Add your transcripts** - The more reference material, the better the output
2. **Document your brand voice** - Fill out the tone guide for consistent content
3. **Use examples** - Add your best content to help the AI learn your style
4. **Start with /content plan** - For complex projects, plan first
5. **Iterate** - Request variations and refine the output

---

## Copywriting Frameworks Used

The 10X Content Expert uses proven frameworks:

- **AIDA** - Attention, Interest, Desire, Action
- **PAS** - Problem, Agitate, Solution
- **BAB** - Before, After, Bridge
- **4Ps** - Promise, Picture, Proof, Push
- **Hook-Story-Offer** - For video/long-form content

Access the full framework reference with `/content frameworks`.

---

## License

MIT License - Free to use and modify.

---

## Quick Reference

```bash
# Setup (run once)
python setup.py

# Start Claude Code
claude

# Get started
/content

# Example commands
"Write a LinkedIn post about [topic]"
"Create an email sequence for [goal]"
"Analyze my transcripts for content ideas"
"Generate headlines for my blog post"
```

---

**Built for content creators who want to 10X their output while maintaining quality and brand consistency.**