@stephen-lord/docs 1.0.0

package/dist/awesome-claude-skills/changelog-generator/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: changelog-generator
+description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+---
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog 
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different 
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts
+

package/dist/awesome-claude-skills/competitive-ads-extractor/SKILL.md

@@ -0,0 +1,293 @@
+---
+name: competitive-ads-extractor
+description: Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.
+---
+
+# Competitive Ads Extractor
+
+This skill extracts your competitors' ads from ad libraries and analyzes what's working—the problems they're highlighting, use cases they're targeting, and copy/creative that's resonating.
+
+## When to Use This Skill
+
+- Researching competitor ad strategies
+- Finding inspiration for your own ads
+- Understanding market positioning
+- Identifying successful ad patterns
+- Analyzing messaging that works
+- Discovering new use cases or pain points
+- Planning ad campaigns with proven concepts
+
+## What This Skill Does
+
+1. **Extracts Ads**: Scrapes ads from Facebook Ad Library, LinkedIn, etc.
+2. **Captures Screenshots**: Saves visual copies of all ads
+3. **Analyzes Messaging**: Identifies problems, use cases, and value props
+4. **Categorizes Ads**: Groups by theme, audience, or format
+5. **Identifies Patterns**: Finds common successful approaches
+6. **Provides Insights**: Explains why certain ads likely perform well
+
+## How to Use
+
+### Basic Extraction
+
+```
+Extract all current ads from [Competitor Name] on Facebook Ad Library
+```
+
+```
+Scrape ads from [Company] and analyze their messaging
+```
+
+### Specific Analysis
+
+```
+Get all ads from [Competitor] focusing on their messaging 
+about [specific problem]. What pain points are they highlighting?
+```
+
+### Competitive Set
+
+```
+Extract ads from these 5 competitors: [list]. 
+Compare their approaches and tell me what's working.
+```
+
+### Specific Platform
+
+```
+Get LinkedIn ads from [Competitor] and analyze their 
+B2B positioning strategy
+```
+
+## Example
+
+**User**: "Extract ads from Notion on Facebook Ad Library and tell me what messaging is working for them."
+
+**Process**:
+```
+Accessing Facebook Ad Library...
+Searching for: Notion
+Found: 23 active ads
+
+Extracting screenshots...
+[████████████████████] 100%
+
+Saved to: competitor-ads/notion/
+- ad-001-collaboration.png
+- ad-002-productivity.png
+- ad-003-templates.png
+...
+
+Analyzing messaging...
+```
+
+**Output**:
+```
+# Notion Ad Analysis
+
+## Overview
+- Total Ads: 23 active
+- Primary Themes: Productivity (35%), Collaboration (30%), 
+  Templates (20%), AI Features (15%)
+- Ad Formats: Static images (60%), Video (40%)
+- CTA Patterns: "Try for free", "Get started"
+
+## Key Problems They're Highlighting
+
+1. **Scattered Information** (8 ads)
+   Copy: "Stop switching between 10 different tools"
+   Why it works: Direct pain point many teams face
+
+2. **Meeting Overload** (5 ads)
+   Copy: "Replace unnecessary meetings with async updates"
+   Why it works: Post-COVID remote work pain point
+
+3. **Lost Documentation** (4 ads)
+   Copy: "Never ask 'where is that doc?' again"
+   Why it works: Universal workplace frustration
+
+## Successful Creative Patterns
+
+### Pattern 1: Before/After Split
+- Shows chaotic tool landscape → Clean Notion workspace
+- Used in 6 high-performing ads
+- Visual metaphor is immediately clear
+
+### Pattern 2: Feature Showcase
+- GIF of actual product usage
+- Shows specific feature in 5 seconds
+- Used for new features (AI, templates)
+
+### Pattern 3: Social Proof
+- "Join 20M users" messaging
+- Customer logos
+- Used in 4 ads targeting enterprise
+
+## Copy That's Working
+
+Best Headlines:
+1. "Your team's knowledge, finally in one place"
+   → Benefit-focused, addresses pain directly
+   
+2. "The all-in-one workspace"
+   → Clear positioning, broad appeal
+   
+3. "AI that actually helps you work"
+   → Addresses AI skepticism, practical angle
+
+Best Body Copy Patterns:
+- Short sentences (under 10 words)
+- Focus on outcomes not features
+- Include specific numbers ("Cut meetings by 50%")
+
+## Audience Targeting Insights
+
+Based on ad variations:
+- Startup founders: Solo productivity angle
+- Team leads: Collaboration and alignment
+- Enterprise: Security and compliance mentions
+- Students: Free plan, templates, organization
+
+## Recommendations for Your Ads
+
+1. **Test the "tool sprawl" pain point**
+   → Strong resonance based on their ad frequency
+
+2. **Use product screenshots over abstract visuals**
+   → All their top ads show actual UI
+
+3. **Lead with the problem, not the solution**
+   → "Tired of X?" performs better than "Introducing Y"
+
+4. **Keep copy under 100 characters**
+   → Their shortest ads seem most frequent
+
+5. **Test before/after visual formats**
+   → Proven pattern in their creative
+
+## Files Saved
+- All ads: ~/competitor-ads/notion/
+- Analysis: ~/competitor-ads/notion/analysis.md
+- Best performers: ~/competitor-ads/notion/top-10/
+```
+
+**Inspired by:** Sumant Subrahmanya's use case from Lenny's Newsletter
+
+## What You Can Learn
+
+### Messaging Analysis
+- What problems they emphasize
+- How they position against competition
+- Value propositions that resonate
+- Target audience segments
+
+### Creative Patterns
+- Visual styles that work
+- Video vs. static image performance
+- Color schemes and branding
+- Layout patterns
+
+### Copy Formulas
+- Headline structures
+- Call-to-action patterns
+- Length and tone
+- Emotional triggers
+
+### Campaign Strategy
+- Seasonal campaigns
+- Product launch approaches
+- Feature announcement tactics
+- Retargeting patterns
+
+## Best Practices
+
+### Legal & Ethical
+✓ Only use for research and inspiration
+✓ Don't copy ads directly
+✓ Respect intellectual property
+✓ Use insights to inform original creative
+✗ Don't plagiarize copy or steal designs
+
+### Analysis Tips
+1. **Look for patterns**: What themes repeat?
+2. **Track over time**: Save ads monthly to see evolution
+3. **Test hypotheses**: Adapt successful patterns for your brand
+4. **Segment by audience**: Different messages for different targets
+5. **Compare platforms**: LinkedIn vs Facebook messaging differs
+
+## Advanced Features
+
+### Trend Tracking
+```
+Compare [Competitor]'s ads from Q1 vs Q2. 
+What messaging has changed?
+```
+
+### Multi-Competitor Analysis
+```
+Extract ads from [Company A], [Company B], [Company C]. 
+What are the common patterns? Where do they differ?
+```
+
+### Industry Benchmarks
+```
+Show me ad patterns across the top 10 project management 
+tools. What problems do they all focus on?
+```
+
+### Format Analysis
+```
+Analyze video ads vs static image ads from [Competitor]. 
+Which gets more engagement? (if data available)
+```
+
+## Common Workflows
+
+### Ad Campaign Planning
+1. Extract competitor ads
+2. Identify successful patterns
+3. Note gaps in their messaging
+4. Brainstorm unique angles
+5. Draft test ad variations
+
+### Positioning Research
+1. Get ads from 5 competitors
+2. Map their positioning
+3. Find underserved angles
+4. Develop differentiated messaging
+5. Test against their approaches
+
+### Creative Inspiration
+1. Extract ads by theme
+2. Analyze visual patterns
+3. Note color and layout trends
+4. Adapt successful patterns
+5. Create original variations
+
+## Tips for Success
+
+1. **Regular Monitoring**: Check monthly for changes
+2. **Broad Research**: Look at adjacent competitors too
+3. **Save Everything**: Build a reference library
+4. **Test Insights**: Run your own experiments
+5. **Track Performance**: A/B test inspired concepts
+6. **Stay Original**: Use for inspiration, not copying
+7. **Multiple Platforms**: Compare Facebook, LinkedIn, TikTok, etc.
+
+## Output Formats
+
+- **Screenshots**: All ads saved as images
+- **Analysis Report**: Markdown summary of insights
+- **Spreadsheet**: CSV with ad copy, CTAs, themes
+- **Presentation**: Visual deck of top performers
+- **Pattern Library**: Categorized by approach
+
+## Related Use Cases
+
+- Writing better ad copy for your campaigns
+- Understanding market positioning
+- Finding content gaps in your messaging
+- Discovering new use cases for your product
+- Planning product marketing strategy
+- Inspiring social media content
+

package/dist/awesome-claude-skills/connect/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: connect
+description: Connect Claude to any app. Send emails, create issues, post messages, update databases - take real actions across Gmail, Slack, GitHub, Notion, and 1000+ services.
+---
+
+# Connect
+
+Connect Claude to any app. Stop generating text about what you could do - actually do it.
+
+## When to Use This Skill
+
+Use this skill when you need Claude to:
+
+- **Send that email** instead of drafting it
+- **Create that issue** instead of describing it
+- **Post that message** instead of suggesting it
+- **Update that database** instead of explaining how
+
+## What Changes
+
+| Without Connect | With Connect |
+|-----------------|--------------|
+| "Here's a draft email..." | Sends the email |
+| "You should create an issue..." | Creates the issue |
+| "Post this to Slack..." | Posts it |
+| "Add this to Notion..." | Adds it |
+
+## Supported Apps
+
+**1000+ integrations** including:
+
+- **Email:** Gmail, Outlook, SendGrid
+- **Chat:** Slack, Discord, Teams, Telegram
+- **Dev:** GitHub, GitLab, Jira, Linear
+- **Docs:** Notion, Google Docs, Confluence
+- **Data:** Sheets, Airtable, PostgreSQL
+- **CRM:** HubSpot, Salesforce, Pipedrive
+- **Storage:** Drive, Dropbox, S3
+- **Social:** Twitter, LinkedIn, Reddit
+
+## Setup
+
+### 1. Get API Key
+
+Get your free key at [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills)
+
+### 2. Set Environment Variable
+
+```bash
+export COMPOSIO_API_KEY="your-key"
+```
+
+### 3. Install
+
+```bash
+pip install composio          # Python
+npm install @composio/core    # TypeScript
+```
+
+Done. Claude can now connect to any app.
+
+## Examples
+
+### Send Email
+```
+Email sarah@acme.com - Subject: "Shipped!" Body: "v2.0 is live, let me know if issues"
+```
+
+### Create GitHub Issue
+```
+Create issue in my-org/repo: "Mobile timeout bug" with label:bug
+```
+
+### Post to Slack
+```
+Post to #engineering: "Deploy complete - v2.4.0 live"
+```
+
+### Chain Actions
+```
+Find GitHub issues labeled "bug" from this week, summarize, post to #bugs on Slack
+```
+
+## How It Works
+
+Uses Composio Tool Router:
+
+1. **You ask** Claude to do something
+2. **Tool Router finds** the right tool (1000+ options)
+3. **OAuth handled** automatically
+4. **Action executes** and returns result
+
+### Code
+
+```python
+from composio import Composio
+from claude_agent_sdk.client import ClaudeSDKClient
+from claude_agent_sdk.types import ClaudeAgentOptions
+import os
+
+composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"])
+session = composio.create(user_id="user_123")
+
+options = ClaudeAgentOptions(
+    system_prompt="You can take actions in external apps.",
+    mcp_servers={
+        "composio": {
+            "type": "http",
+            "url": session.mcp.url,
+            "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]},
+        }
+    },
+)
+
+async with ClaudeSDKClient(options) as client:
+    await client.query("Send Slack message to #general: Hello!")
+```
+
+## Auth Flow
+
+First time using an app:
+```
+To send emails, I need Gmail access.
+Authorize here: https://...
+Say "connected" when done.
+```
+
+Connection persists after that.
+
+## Framework Support
+
+| Framework | Install |
+|-----------|---------|
+| Claude Agent SDK | `pip install composio claude-agent-sdk` |
+| OpenAI Agents | `pip install composio openai-agents` |
+| Vercel AI | `npm install @composio/core @composio/vercel` |
+| LangChain | `pip install composio-langchain` |
+| Any MCP Client | Use `session.mcp.url` |
+
+## Troubleshooting
+
+- **Auth required** → Click link, authorize, say "connected"
+- **Action failed** → Check permissions in target app
+- **Tool not found** → Be specific: "Slack #general" not "send message"
+
+---
+
+<p align="center">
+  <b>Join 20,000+ developers building agents that ship</b>
+</p>
+
+<p align="center">
+  <a href="https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills">
+    <img src="https://img.shields.io/badge/Get_Started_Free-4F46E5?style=for-the-badge" alt="Get Started"/>
+  </a>
+</p>

package/dist/awesome-claude-skills/connect-apps/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: connect-apps
+description: Connect Claude to external apps like Gmail, Slack, GitHub. Use this skill when the user wants to send emails, create issues, post messages, or take actions in external services.
+---
+
+# Connect Apps
+
+Connect Claude to 1000+ apps. Actually send emails, create issues, post messages - not just generate text about it.
+
+## Quick Start
+
+### Step 1: Install the Plugin
+
+```
+/plugin install composio-toolrouter
+```
+
+### Step 2: Run Setup
+
+```
+/composio-toolrouter:setup
+```
+
+This will:
+- Ask for your free API key (get one at [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills))
+- Configure Claude's connection to 1000+ apps
+- Take about 60 seconds
+
+### Step 3: Try It!
+
+After setup, restart Claude Code and try:
+
+```
+Send me a test email at YOUR_EMAIL@example.com
+```
+
+If it works, you're connected!
+
+## What You Can Do
+
+| Ask Claude to... | What happens |
+|------------------|--------------|
+| "Send email to sarah@acme.com about the launch" | Actually sends the email |
+| "Create GitHub issue: fix login bug" | Creates the issue |
+| "Post to Slack #general: deploy complete" | Posts the message |
+| "Add meeting notes to Notion" | Adds to Notion |
+
+## Supported Apps
+
+**Email:** Gmail, Outlook, SendGrid
+**Chat:** Slack, Discord, Teams, Telegram
+**Dev:** GitHub, GitLab, Jira, Linear
+**Docs:** Notion, Google Docs, Confluence
+**Data:** Sheets, Airtable, PostgreSQL
+**And 1000+ more...**
+
+## How It Works
+
+1. You ask Claude to do something
+2. Composio Tool Router finds the right tool
+3. First time? You'll authorize via OAuth (one-time)
+4. Action executes and returns result
+
+## Troubleshooting
+
+- **"Plugin not found"** → Make sure you ran `/plugin install composio-toolrouter`
+- **"Need to authorize"** → Click the OAuth link Claude provides, then say "done"
+- **Action failed** → Check you have permissions in the target app
+
+---
+
+<p align="center">
+  <b>Join 20,000+ developers building agents that ship</b>
+</p>
+
+<p align="center">
+  <a href="https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills">
+    <img src="https://img.shields.io/badge/Get_Started_Free-4F46E5?style=for-the-badge" alt="Get Started"/>
+  </a>
+</p>

package/dist/awesome-claude-skills/connect-apps-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "connect-apps",
+  "description": "Manage auth and connect to 500+ apps using Composio. Perform real actions from Claude Code - send emails, create issues, post messages, and more.",
+  "author": {
+    "name": "Composio",
+    "email": "support@composio.dev"
+  }
+}

package/dist/awesome-claude-skills/connect-apps-plugin/README.md

@@ -0,0 +1,47 @@
+# Connect Apps Plugin
+
+Let Claude perform real actions in 500+ apps. Handles auth and connections using Composio under the hood.
+
+## Install
+
+```bash
+claude --plugin-dir ./connect-apps-plugin
+```
+
+Then run the setup:
+```
+/connect-apps:setup
+```
+
+## What You Get
+
+Once installed, Claude can:
+- **Send emails** via Gmail, Outlook
+- **Create issues** on GitHub, GitLab, Jira, Linear
+- **Post messages** to Slack, Discord, Teams
+- **Update docs** in Notion, Google Docs
+- **Manage data** in Sheets, Airtable, databases
+- **And 500+ more actions**
+
+## How It Works
+
+1. Get a free API key from [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills)
+2. Run `/connect-apps:setup` and paste your key
+3. Restart Claude Code
+4. First time using an app, you'll authorize via OAuth
+5. That's it - Claude can now take real actions
+
+## Try It
+
+After setup, ask Claude:
+```
+Send me a test email at myemail@example.com
+```
+
+---
+
+<p align="center">
+  <a href="https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills">
+    <img src="https://img.shields.io/badge/Get_API_Key-4F46E5?style=for-the-badge" alt="Get API Key"/>
+  </a>
+</p>