n8n-skills-catalog

# n8n Skills Catalog

**When to use**: Need to find the right skill for a task, explore available capabilities, or get started with n8n automation.

## 🎯 Quick Skill Finder

### I need to...

**Fix n8n errors or issues**
→ Use: `n8n-best-practices`
- Code node errors
- HTTP request failures
- Environment variable issues
- Data flow problems

**Scrape websites**
→ Use: `anti-scraping`
- Bypass Cloudflare
- JavaScript rendering
- Multi-page scraping

**Integrate AI models**
→ Use: `ai-integration`
- OpenAI, Qwen, Claude
- Structured output parsing
- Content analysis

**Work with Notion**
→ Use: `notion-operations`
- Create/update pages
- Query databases
- Sync data

**Handle OAuth tokens**
→ Use: `oauth-automation`
- Auto-refresh tokens
- YouTube/Google APIs
- Prevent expiration

**Process videos**
→ Use: `video-processing`
- Extract subtitles
- Analyze content
- Generate timestamps

## 📚 All Available Skills

### 🔧 Core & Best Practices

**n8n-best-practices** ⭐ **START HERE**
- ES5 syntax requirements
- HTTP request patterns
- Environment variables
- Data flow patterns
- Common pitfalls
- Debugging strategies

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/n8n-best-practices/`

### 🌐 Web Scraping

**anti-scraping**
- Cloudflare bypass
- Playwright automation
- Stealth configurations
- Screenshot debugging

**pagination**
- Multi-page scraping
- URL generation
- Batch processing

**html-parsing**
- Cheerio extraction
- CSS selectors
- Data extraction patterns

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/anti-scraping/`, `pagination/`, `html-parsing/`

### 🤖 AI Integration

**ai-integration**
- Multi-provider support (OpenAI, Qwen, Claude)
- Structured output parsing
- Prompt engineering
- Schema validation
- Error handling

**idea-generation**
- Content clustering
- Batch processing
- Multilingual output
- Creative automation

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/ai-integration/`, `idea-generation/`

### 📊 Data & Storage

**notion-operations**
- Complete CRUD operations
- All field types
- Database synchronization
- Query patterns
- Structured data design

**notion-link-analysis**
- URL → AI → Notion automation
- Content extraction
- Auto-tagging
- Knowledge management

**notion-database-sync**
- Sync between databases
- Deduplication
- Field mapping
- Status tracking

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/notion-operations/`, `notion-link-analysis/`, `notion-database-sync/`

### 🔐 Authentication

**n8n-oauth-automation**
- OAuth token refresh
- Real-time updates
- Scheduled refresh
- Google/YouTube APIs
- Hybrid patterns

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/n8n-oauth-automation/`

### 🎥 Media Processing

**video-processing**
- YouTube subtitle extraction
- VTT parsing
- Timestamp handling
- Screenshot generation
- Video metadata

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/video-processing/`

### 🛠️ Utilities

**error-handling**
- Retry logic
- Exponential backoff
- Error classification

**data-processing**
- Deduplication
- Aggregation
- Data cleaning

**data-export**
- CSV generation
- Special character handling
- Encoding

**debugging**
- Data inspection
- Validation
- Quality checks

**feishu-integration**
- Feishu/Lark messaging
- Notifications
- Card messages

**Location**: `/mnt/d/work/n8n_agent/n8n-skills/error-handling/`, `data-processing/`, `data-export/`, `debugging/`, `feishu-integration/`

## 🔗 Common Workflow Patterns

### Pattern 1: Web Scraping Pipeline
```
anti-scraping → html-parsing → data-processing → data-export
```
**Use for**: E-commerce scraping, content collection, price monitoring

### Pattern 2: AI Content Analysis
```
input → ai-integration → notion-operations
```
**Use for**: Content analysis, auto-tagging, knowledge management

### Pattern 3: Video Intelligence
```
oauth-automation → video-processing → ai-integration → notion-operations
```
**Use for**: Video indexing, show notes, content summarization

### Pattern 4: Link Collection
```
webhook → notion-link-analysis → notion database
```
**Use for**: Research, content curation, inspiration collection

### Pattern 5: Database Sync
```
schedule → notion-database-sync → target database
```
**Use for**: Cross-database synchronization, data migration

## 🚀 Getting Started Guide

### Step 1: Identify Your Need
1. What are you trying to automate?
2. What data sources/APIs are involved?
3. What output do you need?

### Step 2: Find Relevant Skills
Use the Quick Skill Finder above or browse by category.

### Step 3: Read the Documentation
Each skill has detailed `SKILL.md` with:
- When to use it
- Quick start examples
- Complete patterns
- Troubleshooting

### Step 4: Check Best Practices FIRST
Always read `n8n-best-practices` before implementing:
- Avoid ES6 syntax errors
- Use correct HTTP patterns
- Handle environment variables properly

### Step 5: Combine Skills
Most complex workflows use multiple skills together.

## 📖 Documentation Structure

### For Each Skill

**Quick Reference**:
- `.claude/skills/{skill-name}/SKILL.md` - Claude Code skill
- Optimized for quick lookup during development

**Complete Documentation**:
- `/mnt/d/work/n8n_agent/n8n-skills/{skill-name}/README.md` - Full guide
- Code files (`.js`) - Copy-paste ready implementations
- Examples and templates

### Key Files to Read

**Essential** (Read First):
1. `n8n-best-practices/README.md` - Critical n8n patterns
2. `n8n-skills/README.md` - Complete skill catalog
3. `SKILLS_RETRIEVAL_GUIDE.md` - How to use skills effectively

**Project Level**:
- `/mnt/d/work/n8n_agent/CLAUDE.md` - Repository guide
- `/mnt/d/work/n8n_agent/n8n-skills/QUICK_START.md` - Quick start guide

## 🔍 How to Search for Solutions

### Method 1: By Problem
"I'm getting error X" → `n8n-best-practices`
"Need to scrape site Y" → `anti-scraping`
"OAuth token expired" → `oauth-automation`

### Method 2: By Technology
YouTube → `video-processing` + `oauth-automation`
Notion → `notion-operations`
AI/LLM → `ai-integration`
Cloudflare → `anti-scraping`

### Method 3: By Pattern
Single page → `anti-scraping` + `html-parsing`
Multi-page → Add `pagination`
With AI → Add `ai-integration`
Save to Notion → Add `notion-operations`

### Method 4: By Keyword
```bash
# Search in skills directory
grep -r "keyword" /mnt/d/work/n8n_agent/n8n-skills/*/README.md
```

## 💡 Tips for Success

### Golden Rules
1. **Check Best Practices FIRST** - Saves hours of debugging
2. **Use ES5 syntax only** - No arrow functions, template literals
3. **Use `require('https')`** - Not `$http` or `axios`
4. **Export environment variables** - Don't just `source`
5. **Preserve data flow** - Always spread previous data

### Common Mistakes to Avoid
- ❌ Using ES6 syntax in Code nodes
- ❌ Using `$http` for HTTP requests
- ❌ Not exporting environment variables
- ❌ Losing upstream data in transformations
- ❌ Hardcoding credentials

### When Stuck
1. Check `n8n-best-practices/README.md`
2. Search relevant skill documentation
3. Check error message against known issues
4. Test code outside n8n first
5. Simplify workflow to isolate problem

## 📊 Skills by Difficulty

**⭐ Easy (Start Here)**
- data-processing
- data-export
- debugging
- error-handling

**⭐⭐ Moderate**
- html-parsing
- pagination
- feishu-integration

**⭐⭐⭐ Intermediate**
- anti-scraping
- notion-operations
- ai-integration

**⭐⭐⭐⭐ Advanced**
- video-processing
- oauth-automation
- notion-database-sync

**⭐⭐⭐⭐⭐ Expert**
- n8n-best-practices (must know)
- Complete workflow architecture

## 🔗 Related Resources

**Full Skills Library**:
`/mnt/d/work/n8n_agent/n8n-skills/`

**Python Workflow Agent**:
`/mnt/d/work/n8n_agent/n8n-workflow-agent/`

**Repository Guide**:
`/mnt/d/work/n8n_agent/CLAUDE.md`

## 📞 How to Use This Catalog

**During Development**:
1. Problem occurs → Search this catalog
2. Find relevant skill
3. Read skill's SKILL.md
4. Check full README.md if needed
5. Copy code and adapt

**Planning New Workflow**:
1. List requirements
2. Map to skills using Quick Finder
3. Read each skill's documentation
4. Design workflow combining skills
5. Implement with best practices

**Learning**:
1. Start with `n8n-best-practices`
2. Try simple skills (data-export, debugging)
3. Progress to intermediate (anti-scraping, ai-integration)
4. Combine skills for complex workflows
5. Contribute back improvements

---

**Last Updated**: 2025-11-03
**Total Skills**: 14+
**Total Code Files**: 43+
**Lines of Documentation**: 8500+