openclaudia__openclaudia-skills/USAGE.md

How to Use OpenClaudia

A practical guide to getting the most out of OpenClaudia's 65+ marketing skills in Claude Code.

---

Table of Contents

• Prerequisites
• Installation
• Your First Skill
• Skill Categories & Workflows
  • SEO Workflow
  • Content Marketing Workflow
  • Social Media Workflow
  • Email Marketing Workflow
  • Ads & Conversion Workflow
  • Analytics & Reporting Workflow
  • Strategy & Planning Workflow
• Setting Up API Keys
• Combining Skills
• Project-Level vs Global Skills
• Tips & Best Practices
• Troubleshooting

---

Prerequisites

1. Claude Code installed and authenticated. Install guide
2. A terminal (macOS, Linux, or WSL on Windows)
3. Node.js 18+ (for the installer CLI)

Installation

Install all skills (recommended for first-time users)

npx openclaudia install --all

This copies all 62+ skill files to ~/.claude/skills/, making them available as slash commands in every Claude Code session.

Install specific skills

# Just the ones you need
npx openclaudia install seo-audit write-blog reddit-marketing

# List available skills
npx openclaudia list

Manual installation

# Clone the repo
git clone https://github.com/OpenClaudia/openclaudia-skills.git

# Copy skills to your global skills directory
cp -r openclaudia-skills/skills/seo-audit ~/.claude/skills/

# Or to a specific project
cp -r openclaudia-skills/skills/seo-audit ./your-project/.claude/skills/

Verify installation

Open Claude Code and type / — you should see the installed skills listed as available slash commands.

---

Your First Skill

Let's run an SEO audit to see how skills work:

$ claude

> /seo-audit https://yoursite.com

Claude will:

1. Crawl your site's key pages
2. Check meta tags, headings, schema markup, and page speed
3. Analyze keyword optimization and internal linking
4. Generate a detailed report with actionable fixes
5. Save the report as a file in your project

That's it. Every skill follows this pattern: invoke with a slash command, provide input, get output.

---

Skill Categories & Workflows

SEO Workflow

Start with an audit, then fix issues systematically.

# Step 1: Audit your site
> /seo-audit https://yoursite.com

# Step 2: Research keywords for your niche
> /keyword-research "AI form builder"

# Step 3: Analyze what competitors rank for
> /serp-analyzer "best AI form builder 2026"

# Step 4: Audit your backlink profile
> /backlink-audit https://yoursite.com

# Step 5: Generate schema markup for key pages
> /schema-markup https://yoursite.com/pricing

# Step 6: Create SEO pages at scale
> /programmatic-seo "Create city landing pages for 50 US metros"

Skills used: seo-audit → keyword-research → serp-analyzer → backlink-audit → schema-markup → programmatic-seo

Content Marketing Workflow

Plan your content strategy, then produce and distribute.

# Step 1: Build a content strategy
> /content-strategy "B2B SaaS project management tool"

# Step 2: Find content gaps vs competitors
> /content-gap-analysis competitor1.com competitor2.com

# Step 3: Create a content brief for writers
> /seo-content-brief "best project management tools for remote teams"

# Step 4: Write the blog post
> /write-blog "Best Project Management Tools for Remote Teams in 2026"

# Step 5: Polish the copy
> /copy-editing ./blog-post.md

# Step 6: Repurpose into social content
> /content-repurposing ./blog-post.md

Skills used: content-strategy → content-gap-analysis → seo-content-brief → write-blog → copy-editing → content-repurposing

Social Media Workflow

Create and distribute content across platforms.

# Step 1: Plan a content calendar
> /content-calendar "SaaS product launch, 4 weeks, focus on LinkedIn and Reddit"

# Step 2: Write a LinkedIn thought leadership post
> /linkedin-content "Lessons learned scaling to 100K users"

# Step 3: Create a Reddit marketing campaign
> /reddit-marketing "Share our AI form builder in relevant subreddits"

# Step 4: Write a viral thread for X
> /thread-writer "How we grew from 0 to 100K monthly visitors in 12 months"

# Step 5: Cross-post to Bluesky
> /bluesky "Announce our new feature launch"

# Step 6: Post to Discord and Slack
> /discord-bot "New feature: AI-powered form validation"
> /slack-bot "Weekly marketing update: traffic up 20%"

Skills used: content-calendar → linkedin-content → reddit-marketing → thread-writer → bluesky → discord-bot / slack-bot

Email Marketing Workflow

Build email sequences that convert.

# Step 1: Create a drip campaign
> /email-sequence --type product-launch

# Step 2: A/B test subject lines
> /email-subject-lines "Product launch announcement for AI form builder"

Skills used: email-sequence → email-subject-lines

Note: Requires RESEND_API_KEY to actually send emails. Without it, skills generate the email copy for you to send manually.

Ads & Conversion Workflow

Optimize your ad spend and landing pages.

# Step 1: Create Google Ads campaigns
> /google-ads "AI form builder, target: small business owners, budget: $2000/month"

# Step 2: Create Facebook/Meta ad campaigns
> /facebook-ads "Retarget website visitors with feature demo video"

# Step 3: Create LinkedIn ads for B2B
> /linkedin-ads "Target VP Engineering at companies with 50-500 employees"

# Step 4: Optimize landing page conversion
> /page-cro https://yoursite.com/pricing

# Step 5: Set up A/B tests
> /ab-test-setup "Test pricing page with annual vs monthly toggle"

# Step 6: Analyze video ad performance
> /video-ad-analysis "Review our top 3 YouTube pre-roll ads"

Skills used: google-ads → facebook-ads → linkedin-ads → page-cro → ab-test-setup → video-ad-analysis

Analytics & Reporting Workflow

Pull data from your tools and generate insights.

# Step 1: Check Google Analytics
> /google-analytics "Show me traffic trends for the last 90 days"

# Step 2: Analyze Search Console performance
> /search-console "Top queries and pages for the last month"

# Step 3: Run SemRush competitive analysis
> /semrush-research "Compare our domain with competitor.com"

# Step 4: Pull Google Ads performance
> /google-ads-report "Campaign performance for March 2026"

# Step 5: Check YouTube channel stats
> /youtube-analytics "Video performance for the last 30 days"

# Step 6: Monitor brand mentions
> /brand-monitor "Track mentions of our brand across the web"

Skills used: google-analytics → search-console → semrush-research → google-ads-report → youtube-analytics → brand-monitor

Strategy & Planning Workflow

Plan your marketing strategy from scratch.

# Step 1: Define your ideal customer
> /icp-builder "B2B SaaS selling to enterprise HR teams"

# Step 2: Analyze competitors
> /competitor-analysis competitor.com

# Step 3: Build a growth strategy
> /growth-strategy "Double organic traffic in 6 months"

# Step 4: Plan a product launch
> /launch-strategy "Launching v2.0 of our platform in Q2"

# Step 5: Optimize pricing
> /pricing-strategy https://yoursite.com/pricing

# Step 6: Get creative marketing ideas
> /marketing-ideas "We're a dev tools startup with $5K/month marketing budget"

Skills used: icp-builder → competitor-analysis → growth-strategy → launch-strategy → pricing-strategy → marketing-ideas

---

Setting Up API Keys

Skills work without API keys (using web search and free data), but they're more powerful with live API access.

Create a file at ~/.claude/.env.global or add to your project's .env:

# Most impactful keys to set up first:
RESEND_API_KEY=your_key        # Enables actual email sending
SEMRUSH_API_KEY=your_key       # Rich SEO & keyword data
UNSPLASH_CLIENT_ID=your_key    # Featured images for blog posts

See the full list of API keys in the README.

Priority order for API setup:

1. Resend — if you want to send emails directly
2. SemRush or Ahrefs — for real keyword and backlink data
3. Google OAuth — for Analytics, Search Console, and Ads reporting
4. Unsplash — for stock images in blog posts
5. Everything else — add as needed for specific skills

---

Combining Skills

The real power of OpenClaudia is chaining skills together. You can ask Claude to run multiple skills in one conversation:

Example: Full content pipeline

> Research keywords for "AI form builder", write a blog post targeting the best
> keyword, then create a LinkedIn post and Reddit comment promoting it.

Claude will automatically use keyword-research → write-blog → linkedin-content → reddit-marketing in sequence.

Example: Competitor teardown

> Do a full competitor analysis of competitor.com — SEO audit, content gap
> analysis, and backlink comparison. Then create a content strategy to beat them.

Claude chains: competitor-analysis → seo-audit → content-gap-analysis → backlink-audit → content-strategy

Example: Launch campaign

> We're launching a new feature next week. Create a launch strategy, write the
> announcement blog post, email sequence, social media posts, and Discord
> announcement.

Claude uses: launch-strategy → write-blog → email-sequence → social-content → discord-bot

---

Project-Level vs Global Skills

Global skills (~/.claude/skills/)

Available in every Claude Code session, across all projects. This is where npx openclaudia install puts skills by default.

Best for: general marketing skills you use everywhere.

Project-level skills (.claude/skills/)

Available only in that project's Claude Code sessions. Use this when you want to customize a skill for a specific project.

# Copy and customize a skill for your project
cp -r ~/.claude/skills/write-blog .claude/skills/write-blog

# Edit the SKILL.md to add project-specific instructions
# e.g., "Always mention our product name as 'FormAI'"

Project-level skills override global skills with the same name.

---

Tips & Best Practices

1. Be specific with your prompts

# Vague — skill has to guess
> /write-blog "AI tools"

# Specific — better output
> /write-blog "10 AI Form Builders Compared: Features, Pricing, and Which One
> to Choose in 2026" --target-keyword "best AI form builder" --word-count 2500

2. Provide context in your project

If your project has a CLAUDE.md file with brand guidelines, tone of voice, or product details, skills will automatically use that context.

3. Review and iterate

Skills generate a first draft. Ask Claude to refine:

> /write-blog "Topic here"
> Make the introduction more compelling and add a comparison table
> Add internal links to our /pricing and /features pages

4. Use natural language, not just slash commands

You don't have to use slash commands. Claude recognizes when a skill is relevant:

> Write a blog post about AI form builders
# Claude automatically uses the write-blog skill

> Audit the SEO on my site
# Claude automatically uses seo-audit

5. Chain skills for comprehensive campaigns

Instead of running skills one at a time, describe your goal and let Claude orchestrate:

> I need a complete content marketing campaign for our product launch next month.
> Start with competitor analysis, then create a content calendar, write the key
> pieces, and set up the email drip campaign.

---

Troubleshooting

Skills don't appear as slash commands

# Reinstall
npx openclaudia install --all

# Check they're in the right place
ls ~/.claude/skills/

API calls fail

# Check your env file
cat ~/.claude/.env.global

# Make sure the key is set (not empty)
echo $RESEND_API_KEY

Skill output isn't what you expected

• Add more context to your prompt
• Check if the skill needs an API key for richer data
• Open an issue if the skill's instructions need improvement

Skills conflict with project-level instructions

Project-level .claude/skills/ takes priority over global ~/.claude/skills/. If a skill behaves differently in one project, check for a project-level override.

---

What's Next?

• Browse the full skill list to see everything available
• Contribute a skill if you have a marketing workflow that's missing
• Star the repo on GitHub to stay updated
• Visit openclaudia.com for tutorials and news

---

_{Questions? Open an issue or reach out at @Claudia1569302}