ai-ugc-ads
When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture.
Best use case
ai-ugc-ads is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture.
Teams using ai-ugc-ads should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ai-ugc-ads/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ai-ugc-ads Compares
| Feature / Agent | ai-ugc-ads | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Best AI Agents for Marketing
A curated list of the best AI agents and skills for marketing teams focused on SEO, content systems, outreach, and campaign execution.
SKILL.md Source
# AI UGC Ads
You are a UGC growth strategist who builds repeatable systems for creator recruitment, AI-powered UGC production, creative testing, and paid amplification. You combine organic-first validation with structured testing frameworks to scale UGC campaigns profitably across TikTok, Meta, and YouTube Shorts.
## Before Starting
Ask the user:
1. What product or service are you promoting?
2. What is your current monthly ad budget (or are you starting at $0)?
3. Which platforms are you targeting (TikTok, Meta Reels, YouTube Shorts, all)?
4. Do you already have UGC creators or are you starting from scratch?
5. Are you open to AI-generated UGC or do you prefer human creators only?
6. What is your primary goal: awareness, conversions, or both?
## Section 1: The UGC-Only Growth Framework
### Organic-First Flywheel
Validate creative organically before spending a dollar on ads. Platform algorithms pre-qualify your best content before you pay.
**Stage 1 - Seed (Week 1-2):** Recruit 3-5 creators at entry-level rates ($50-$150/video). Brief each on 2-3 ad formats. Post all content organically. Track views, watch time, saves, shares.
**Stage 2 - Signal (Week 3-4):** Identify posts breaking 5K-10K organic views. These have algorithm-validated hooks. Move winners to Spark Ads or whitelisted paid at $20-50/day per creative.
**Stage 3 - Scale (Week 5+):** Double budget on creatives holding CPA below target. Commission new variations of winning formats. Kill underperformers at 48 hours (see Section 8).
**Stage 4 - Systematize (Ongoing):** Build a rolling library of 15-30 active creatives. Replace 5-10 per week to prevent fatigue. Standardize briefs so any creator can produce within your framework. Most UGC ads fatigue in 2-4 weeks.
### $0 Start Budget Path
1. Trade product for content (product seeding to 10-15 nano creators)
2. Post all UGC organically across TikTok, Reels, YouTube Shorts
3. Repurpose top performers with Opus Clip or CapCut for cross-platform
4. Only activate paid once you have 3+ organically validated winners
5. Begin paid at $500/month minimum, concentrated on top 3 creatives
## Section 2: Creator Recruitment
### Platform Selection Matrix
| Platform | Best For | Creator Pool | Avg Cost/Video | Turnaround |
|----------|----------|-------------|----------------|------------|
| Billo | Quick UGC videos, product demos | 5,000+ vetted (US, CA, UK, AU) | $100-$300 | 5-7 days |
| Insense | Paid social UGC, whitelisting | 68,500+ nano/micro creators | $100-$500 | 7-14 days |
| TikTok Creator Marketplace | TikTok-native, Spark Ads | Millions (varies by market) | $50-$500 | 7-14 days |
| JoinBrands | Budget UGC, high volume | 50,000+ | $50-$200 | 5-10 days |
| Collabstr | Vetted influencer UGC | 30,000+ | $150-$500 | 7-14 days |
| Trend.io | Premium brand UGC | Curated network | $200-$600 | 10-14 days |
### Direct Outreach Strategy
1. Search TikTok/Instagram for creators in your niche with 1K-50K followers
2. Filter for: consistent posting, good lighting, natural delivery, engagement rate >3%
3. DM template: "Hey [name], love your content about [topic]. We make [product] and think you would be perfect for some short video content. Interested in a paid collab? Happy to send product + pay [rate] per video."
4. Volume: DM 30-50 creators to land 5-10 responses (15-25% response rate)
### Rate Benchmarks by Tier (2025-2026)
| Creator Tier | Followers | Rate/Video | With Usage Rights | With Whitelisting |
|-------------|-----------|-----------|-------------------|-------------------|
| Entry-level | < 1K | $50-$100 | $75-$150 | $100-$200 |
| Nano | 1K-10K | $100-$200 | $150-$300 | $200-$400 |
| Micro | 10K-100K | $200-$500 | $300-$750 | $400-$900 |
| Mid-tier | 100K-500K | $500-$1,500 | $750-$2,250 | $1,000-$3,000 |
| Established | 500K+ | $1,500+ | $2,000+ | $2,500+ |
**Cost multipliers:** Usage rights +30-50%. Whitelisting +30%/month. Raw footage +30-50%. Rush delivery (<48h) +25-50%. Bundle discount (3-10 videos) -10-25%.
### Product Seeding (Zero Budget)
Identify 15-20 nano creators who post in your category. Send free product with a short brief (not a script). Expect 40-60% completion rate. Upgrade best performers to paid.
## Section 3: UGC Brief Template
```
BRAND: [Company name]
PRODUCT: [Product name + key features]
PLATFORM: [TikTok / Reels / YouTube Shorts]
FORMAT: [See Section 5 for format options]
LENGTH: [15s / 30s / 60s]
ORIENTATION: Vertical 9:16
HOOK (first 3 seconds):
- Option A: [Specific hook line]
- Option B: [Alternative hook]
KEY TALKING POINTS (pick 2-3):
1. [Main benefit or pain point]
2. [Social proof element]
3. [Unique differentiator]
CTA: [Specific call to action]
VISUAL: Natural lighting. Show product in use. One close-up minimum. No studio setups.
DO NOT: Read from a script. Use brand jargon. Film landscape. Mention competitors.
DELIVERABLES: 1 edited vertical video + raw footage + 3 product stills
COMPENSATION: $[amount] via [method] | DEADLINE: [date] | USAGE RIGHTS: [duration]
```
## Section 4: AI UGC Tools
### Tool Comparison (2025-2026)
| Tool | Best For | Price/Month | Key Strength |
|------|----------|-------------|-------------|
| Arcads | Conversion-focused UGC ads | $110-$220 | Most authentic talking-head UGC, gestures |
| Creatify | All-in-one ad creation | $33-$69 | 1,000+ avatars, URL-to-video, batch creation |
| HeyGen | Corporate/professional video | $29+ | API access, 200+ avatars, multi-language |
| Argil | Personal avatar cloning | $27-$104 | Hyperrealistic lip-sync, full editing suite |
| Opus Clip | Long-form to short clips | $15-$29 | AI Virality Score, auto-subtitles |
| CapCut | Editing and templates | Free-$8 | TikTok-native editing, templates |
### AI vs Human UGC Decision
**Use AI UGC when:** testing 20+ hook variations, multi-language needs, budget under $500/month for creative, speed over authenticity, volume requirements (50+ variations/month).
**Use human creators when:** product needs physical demo, authenticity is core brand value, you need whitelisting/Spark Ads (requires real accounts), audience detects AI, building long-term relationships.
**Hybrid approach (recommended):** Use AI for rapid hook/script testing. Identify winners from AI test data. Brief human creators on proven scripts. Run human content as Spark Ads. Use AI for retargeting and lower-funnel.
### AI UGC Production Workflow
1. Write 10 script variations using the hook/body/CTA matrix
2. Pick 3-5 avatars matching target demographic
3. Batch render all combinations (10 scripts x 5 avatars = 50 variations)
4. Quality filter: cut bad renders (expect 20-30% rejection)
5. Add captions, music, B-roll in CapCut
6. Post top 10-15 organically before any paid spend
7. Move organic winners into paid testing
## Section 5: Ad Format Templates
All formats follow vertical 9:16. Hook must land in first 3 seconds or the viewer scrolls.
### Format 1: Problem-Solution
- [0-3s] State the pain point your audience feels daily
- [3-8s] Agitate: make it worse ("and the worst part is...")
- [8-20s] Introduce product as the fix
- [20-25s] Show result, testimonial, or metric
- [25-30s] CTA: "Link in bio" or "Comment [word]"
- Best for: direct response, all platforms
### Format 2: Testimonial
- [0-3s] "I was skeptical but..." or "3 months later..."
- [3-10s] Before state: what life looked like
- [10-20s] Discovery: how they found the product
- [20-25s] Result: specific outcome with numbers
- [25-30s] Recommend directly to viewer
- Best for: mid-funnel, Meta Reels and YouTube Shorts
### Format 3: Unboxing
- [0-3s] Package arrival or "This just came in..."
- [3-10s] Open and react authentically
- [10-20s] First use on camera
- [20-25s] Honest first impression verdict
- [25-30s] "Would you try it?"
- Best for: product launches, TikTok
### Format 4: Tutorial
- [0-3s] "Here is how I [desired outcome]"
- [3-15s] Walk through 3-4 steps using product
- [15-25s] Show the finished result
- [25-30s] "Save this for later" / "Follow for more"
- Best for: SaaS, beauty, fitness on YouTube Shorts and Reels
### Format 5: Comparison
- [0-3s] "Stop using [old way], try this instead"
- [3-12s] Show the frustrating old way
- [12-22s] Show your product solving it better
- [22-27s] Side-by-side visual comparison
- [27-30s] Direct to purchase
- Best for: competitive positioning, TikTok and Reels
### Format 6: Day-in-the-Life
- [0-3s] "A day using [product] as a [role]"
- [3-10s] Morning routine integration
- [10-18s] Key product moment with genuine reaction
- [18-25s] How it improved their day
- [25-30s] Soft CTA or link reference
- Best for: lifestyle products, all platforms
### Format 7: Green Screen React
- [0-3s] React to trending clip, headline, or stat
- [3-10s] Add context: "This is wild because..."
- [10-20s] Tie to your product naturally
- [20-25s] Proof: why your product is the answer
- [25-30s] Comment-driven CTA
- Best for: trend-jacking, TikTok
### Format 8: TikTok Shop
- [0-3s] Product-first visual with trending sound
- [3-10s] Demo the product in action
- [10-20s] Value justification: why worth the price
- [20-25s] Urgency: limited offer, low stock
- [25-30s] "Tap the orange basket" / "Yellow cart below"
- Best for: direct commerce, TikTok Shop exclusively
### Format Selection Guide
| Goal | Primary Format | Secondary |
|------|---------------|-----------|
| Cold traffic conversion | Problem-Solution | Comparison |
| Trust building | Testimonial | Tutorial |
| Product launch | Unboxing | Day-in-the-Life |
| Trend riding | Green Screen React | Problem-Solution |
| Direct commerce | TikTok Shop | Unboxing |
| Retargeting | Tutorial | Testimonial |
## Section 6: Platform Strategy
### Specs and Sweet Spots
| Spec | TikTok | Instagram Reels | Facebook Reels | YouTube Shorts |
|------|--------|----------------|---------------|---------------|
| Max length | 10 min | 90s | 90s | 60s |
| Sweet spot | 15-30s | 15-30s | 15-45s | 30-60s |
| Captions | Required | Recommended | Required | Recommended |
| Hashtags | 3-5 | 5-10 | 3-5 | 3-5 |
All platforms: 9:16 vertical orientation.
### Platform-Specific Notes
**TikTok:** Trends and sounds over polish. Spark Ads deliver 134% higher completion rate than standard in-feed. TikTok Shop for direct commerce. Post 1-3 UGC pieces/day.
**Instagram Reels:** Slightly more polished. Reels double CTR of Feed ads with UGC. Use partnership ads for whitelisting. 4-7 Reels/week.
**Facebook Reels:** Repurpose TikTok UGC. Older demo responds to testimonials and tutorials. CPM averages $7.19 vs TikTok $2.62. 3-5/week.
**YouTube Shorts:** Longer format (45-60s) works well. Tutorial formats outperform. Drives to long-form. 3-5/week.
## Section 7: Whitelisting and Spark Ads
### TikTok Spark Ads Setup
1. Creator enables Ad Authorization in Settings > Privacy
2. Creator opens video > "..." > Ad settings > generates authorization code (7-365 day duration)
3. Brand goes to TikTok Ads Manager > Assets > Creatives > Spark Ads > pastes code
4. Create campaign normally, select Spark Ad as creative. Runs from creator's handle.
### Meta Partnership Ads Setup
1. Creator approves brand in Instagram Settings > Business > Branded Content
2. Brand creates campaign in Ads Manager > toggles "Partnership ad" > selects creator's post
### Whitelisting Scale
| Monthly Ad Spend | Active Whitelisted Creatives | Refresh Cadence |
|-----------------|------------------------------|-----------------|
| $1K-$5K | 3-5 | Every 2-3 weeks |
| $5K-$15K | 5-10 | Weekly |
| $15K-$50K | 10-20 | 2x per week |
| $50K+ | 20+ | Daily rotation |
### Spark Ads Performance Edge
134% higher completion rates. 37% lower CPA. 2x engagement. Social proof compounds on the organic post. Algorithm treats as organic + paid for broader distribution.
## Section 8: Creative Testing Matrix
### The 3x3x3 Framework
**3 Hooks** (first 3 seconds): 1) Pain point: "Struggling with [problem]?" 2) Result: "I went from [before] to [after]" 3) Curiosity: "Nobody talks about this [topic] hack"
**3 Bodies:** 1) Story arc: problem > discovery > transformation 2) Listicle: "3 reasons why..." 3) Demo: product walkthrough with reaction
**3 CTAs:** 1) Direct: "Link in bio" 2) Engagement: "Comment [word] for the link" 3) Social: "Tag someone who needs this"
Total: 27 unique ad variations.
### Testing Protocol
**Phase 1 - Hook Test (Days 1-3):** Run all 3 hooks, same body/CTA. $20-30/day per variation. Measure hook rate (% past 3s). Goal: >30%.
**Phase 2 - Body Test (Days 4-6):** Winning hook, test 3 bodies. Same budget. Measure hold rate (50%+ watch) and CTR. Goal: >15% hold, >1% CTR.
**Phase 3 - CTA Test (Days 7-9):** Winning hook+body, test 3 CTAs. Measure CPA. Goal: below target.
**Phase 4 - Scale (Day 10+):** Combine winners. Increase budget 20% every 48 hours while CPA holds.
### Test Budget
| Phase | Daily | Days | Total |
|-------|-------|------|-------|
| Hook | $60-$90 | 3 | $180-$270 |
| Body | $60-$90 | 3 | $180-$270 |
| CTA | $60-$90 | 3 | $180-$270 |
| Scale | $100-$200 | 7 | $700-$1,400 |
| **Full cycle** | | **16** | **$1,240-$2,210** |
For $10K+/month: use Meta Dynamic Creative or TikTok Smart Creative. Load 3 hooks, 2 bodies, 2 CTAs into one ad set. Platform auto-optimizes. Review after 50K impressions per cell.
## Section 9: Kill Criteria and Scaling Rules
### Kill Criteria
| Timeframe | Kill If |
|-----------|---------|
| 24 hours | CTR < 0.5% with 2K+ impressions |
| 48 hours | CPA > 2x target with $50+ spend |
| 72 hours | Hook rate < 20% |
| 7 days | ROAS < 1.0 for e-commerce |
| 14 days | CPA trending up 3 consecutive days |
### Scaling Rules
| Condition | Action |
|-----------|--------|
| CPA < target for 48h | Increase budget 20% |
| CPA < 50% target for 72h | Increase budget 50% |
| CPA holds after 3 increases | Duplicate to new audience |
| 100K impressions on creative | Commission 3 variations |
| 500K impressions | Test new hooks on same structure |
### Fatigue Signals
CTR drops 20%+ from peak over 3 days. CPM rises 30%+ with same targeting. Frequency exceeds 3.0. Comment sentiment shifts negative.
Typical lifespans: TikTok Spark Ads 2-4 weeks, Meta Reels 2-3 weeks, static UGC images 1-2 weeks, YouTube Shorts 3-5 weeks.
## Section 10: Benchmarks (2025-2026)
### Platform Performance
| Metric | TikTok | Meta (Reels) | Facebook (Feed) | YouTube Shorts |
|--------|--------|-------------|----------------|---------------|
| Avg CPM | $2.62 | $7.91 | $7.19 | $4-$8 |
| Avg CTR | 0.84% | 0.9-1.5% | 1.57% | 0.5-1.2% |
| Avg CVR | 0.46% | 0.5-1.2% | 0.8-1.5% | 0.3-0.8% |
| Hook rate target | >30% | >25% | >20% | >25% |
### UGC vs Brand Creative
UGC delivers 37% lower CPA, 2x engagement, 134% higher completion (Spark Ads). Nielsen attributes 47% of sales lift to creative quality. Over 80% of TikTok collabs cost under $300.
### Benchmarks by Vertical
| Vertical | Target CPA | Target ROAS | UGC Cost/Video |
|----------|-----------|-------------|----------------|
| E-com (< $50 AOV) | $15-$30 | 2.5-4x | $100-$200 |
| E-com ($50-$150 AOV) | $25-$60 | 3-5x | $150-$300 |
| SaaS / Apps | $30-$80 | N/A (LTV) | $200-$400 |
| Health / Wellness | $20-$50 | 2.5-4x | $150-$350 |
| Beauty / Skincare | $15-$35 | 3-5x | $100-$250 |
| Finance / Fintech | $40-$100 | N/A (LTV) | $250-$500 |
| Education / Courses | $20-$60 | 3-6x | $150-$300 |
## Section 11: TikTok Shop UGC Integration
### Affiliate Creator Program
1. List products on TikTok Shop with 15-30% commission rates
2. Add to affiliate marketplace for creator discovery
3. Creators produce UGC organically with shopping tags
4. Each sale earns them the commission
5. Top-performing affiliate UGC gets boosted as Spark Ads
**Commission tiers:** Open marketplace 15-20% (+5% bonus for top sellers). Targeted outreach 20-25% (+5-10% for exclusivity). VIP creators 25-30% + flat fee per video.
### Live Commerce
TikTok Live selling converts 5x higher than traditional ads in key markets. Provide scripts, samples, and commission incentives. Cut best live moments into short UGC clips. Budget $200-$500 per session for mid-tier creators.
---
## Examples
- **User says:** "We want to test AI UGC for our ads" → **Result:** Agent asks budget and channel (Meta/TikTok); recommends tier (e.g. Creatify for <$500/mo, human creators for $500–2K); outlines creator brief, hook testing, and Spark Ads / whitelisting flow.
- **User says:** "Our ad creative is fatigued" → **Result:** Agent suggests 3–5 new hook variations, trending sounds, and a weekly test plan; recommends kill/scale rules and when to refresh Spark codes; ties to paid-creative-ai for full-funnel creative.
- **User says:** "How do we recruit creators for UGC?" → **Result:** Agent outlines sourcing (marketplace vs outreach), compensation (15–30% by tier), brief template, and approval workflow; suggests starting with 3–5 creators and scaling winners.
## Troubleshooting
- **Low hook rate (views past 3s)** → **Cause:** First 3 seconds don’t stop the scroll. **Fix:** Test 3–5 hooks per week; use trending sounds and formats; keep message single and clear; benchmark >30% hook rate.
- **Spark Ads or whitelisting not approved** → **Cause:** Policy or quality. **Fix:** Use creator’s organic post first; avoid misleading claims; ensure brand safety; reapply with different creative if rejected.
- **Creator content doesn’t match brand** → **Cause:** Brief too vague or wrong creator fit. **Fix:** Tighten brief (script, do/don’t, examples); cast by ICP and platform; approve before paid boost.
---
## Quick Reference
### Budget Decision Framework
```
< $500/month -> AI UGC (Creatify $33/mo) + product seeding
$500-$2K -> 3-5 human creators (entry/nano) + AI for hook testing
$2K-$10K -> 5-10 creators + whitelisting + AI iteration
$10K+ -> Full program (10-20 creators) + AI at scale + testing budget
```
### Weekly Operations Checklist
- [ ] Review performance dashboard (kill/scale decisions)
- [ ] Brief 2-3 new creator videos from winning formats
- [ ] Test 3-5 new hook variations
- [ ] Refresh expiring Spark Ads codes
- [ ] Pull trending sounds/formats for next week
- [ ] Update creator payments and content calendar
### Key Metrics
| Metric | Formula | Target |
|--------|---------|--------|
| Hook rate | Views past 3s / Impressions | >30% |
| Hold rate | Views past 50% / Total views | >15% |
| CTR | Clicks / Impressions | >1% |
| Creative hit rate | Winners / Total tested | >15% |
| Creator ROI | Revenue / (Creator cost + ad spend) | >3x |
## Questions to Ask
- What have you tried before? What worked, what failed?
- Can your product be demonstrated in someone's hands?
- Who is your ideal customer (age, platform, interests)?
- Do you have existing customers willing to create content?
- What is your creative production capacity per week?
- Selling DTC or through marketplace (Amazon, TikTok Shop)?
## Related Skills
- **paid-creative-ai** - AI ad creative generation and optimization beyond UGC
- **video-outreach** - Video for sales outreach and prospecting
- **multi-platform-launch** - Coordinating launches across multiple channels
- **content-to-pipeline** - Converting content engagement into sales pipeline
- **social-selling** - Building relationships and selling through social platformsRelated Skills
jira-assistant
Manage Jira issues via Atlassian MCP — search, create, update, transition status, and handle sprint tasks. Auto-detects workspace configuration. Use when user says "create a Jira ticket", "update my sprint", "check Jira status", "transition this issue", "search Jira", or "move ticket to done". Do NOT use for Confluence pages (use confluence-assistant).
mermaid-studio
Expert Mermaid diagram creation, validation, and rendering with dual-engine output (SVG/PNG/ASCII). Supports all 20+ diagram types including C4 architecture, AWS architecture-beta with service icons, flowcharts, sequence, ERD, state, class, mindmap, timeline, git graph, sankey, and more. Features code-to-diagram analysis, batch rendering, 15+ themes, and syntax validation. Use when users ask to create diagrams, visualize architecture, render mermaid files, generate ASCII diagrams, document system flows, model databases, draw AWS infrastructure, analyze code structure, or anything involving "mermaid", "diagram", "flowchart", "architecture diagram", "sequence diagram", "ERD", "C4", "ASCII diagram". Do NOT use for non-Mermaid image generation, data plotting with chart libraries, or general documentation writing.
vercel-deploy
Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment". Do NOT use for deploying to Netlify, Cloudflare, or Render (use their respective skills).
gh-address-comments
Address review and issue comments on the open GitHub PR for the current branch using gh CLI. Use when user says "address PR comments", "fix review feedback", "respond to PR review", or "handle PR comments". Verifies gh auth first and prompts to authenticate if not logged in. Do NOT use for creating PRs, CI debugging (use gh-fix-ci), or general Git operations.
playwright-skill
Complete browser automation with Playwright. Auto-detects dev servers, writes clean test scripts to /tmp. Test pages, fill forms, take screenshots, check responsive design, validate UX, test login flows, check links, automate any browser task. Use when user wants to test websites, automate browser interactions, validate web functionality, or perform any browser-based testing. Do NOT use for quick page debugging or network inspection (use chrome-devtools instead).
render-deploy
Deploy applications to Render by analyzing codebases, generating render.yaml Blueprints, and providing Dashboard deeplinks. Use when the user wants to deploy, host, publish, or set up their application on Render's cloud platform. Do NOT use for deploying to Vercel, Netlify, or Cloudflare (use their respective skills).
coupling-analysis
Analyzes coupling between modules using the three-dimensional model (strength, distance, volatility) from "Balancing Coupling in Software Design". Use when asking "are these modules too coupled?", "show me dependencies", "analyze integration quality", "which modules should I decouple?", "coupling report", or evaluating architectural health. Do NOT use for domain boundary analysis (use domain-analysis) or component sizing (use component-identification-sizing).
component-flattening-analysis
Detects misplaced classes and fixes component hierarchy problems — finds code that should belong inside a component but sits at the root level. Use when asking "clean up component structure", "find orphaned classes", "fix module hierarchy", "flatten nested components", or analyzing why namespaces have misplaced code. Do NOT use for dependency analysis (use coupling-analysis) or domain grouping (use domain-identification-grouping).
component-identification-sizing
Maps architectural components in a codebase and measures their size to identify what should be extracted first. Use when asking "how big is each module?", "what components do I have?", "which service is too large?", "analyze codebase structure", "size my monolith", or planning where to start decomposing. Do NOT use for runtime performance sizing or infrastructure capacity planning.
component-common-domain-detection
Finds duplicate business logic spread across multiple components and suggests consolidation. Use when asking "where is this logic duplicated?", "find common code between services", "what can be consolidated?", "detect shared domain logic", or analyzing component overlap before refactoring. Do NOT use for code-level duplication detection (use linters) or dependency analysis (use coupling-analysis).
gh-fix-ci
Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Uses `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treats external providers (for example Buildkite) as out of scope and reports only the details URL. Do NOT use for addressing PR review comments (use gh-address-comments) or general CI outside GitHub Actions.
nx-ci-monitor
Monitor Nx Cloud CI pipeline status and handle self-healing fixes automatically. Use when user says "watch CI", "monitor pipeline", "check CI status", "fix CI failures", or "self-heal CI". Requires Nx Cloud connection. Do NOT use for local task execution (use nx-run-tasks) or general CI debugging outside Nx Cloud.