chore: release 4.4.0 - add fp-ts skills (PR #43 )

chore: sync generated registry files [ci skip]
feat: add fp-ts skills for TypeScript functional programming (#43 )
2026-01-30 20:29:59 +01:00 · 2026-01-30 19:28:08 +00:00 · 2026-01-30 20:27:51 +01:00 · 2026-01-30 08:24:50 +00:00 · 2026-01-30 09:24:33 +01:00 · 2026-01-30 09:21:51 +01:00
24 changed files with 2418 additions and 8251 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,22 @@ walkthrough.md
 .gemini/
 LOCAL_CONFIG.md
 data/node_modules
+
+# Temporary analysis and report files
+*_REPORT.md
+*_ANALYSIS*.md
+*_COUNT.md
+*_SUMMARY.md
+*_analysis.json
+*_validation.json
+*_results.json
+voltagent_*.json
+similar_skills_*.json
+remaining_*.json
+html_*.json
+
+# Temporary analysis scripts
+scripts/*voltagent*.py
+scripts/*html*.py
+scripts/*similar*.py
+scripts/*count*.py
--- a/CATALOG.md
+++ b/CATALOG.md
@@ -1,8 +1,8 @@
 # Skill Catalog

-Generated at: 2026-01-30T08:15:03.985Z
+Generated at: 2026-01-30T19:29:11.960Z

-Total skills: 614
+Total skills: 617

 ## architecture (58)

@@ -109,7 +109,7 @@ Total skills: 614
 | `startup-financial-modeling` | This skill should be used when the user asks to "create financial projections", "build a financial model", "forecast revenue", "calculate burn rate", "estima... | startup, financial, modeling | startup, financial, modeling, skill, should, used, user, asks, projections, model, forecast, revenue |
 | `team-composition-analysis` | This skill should be used when the user asks to "plan team structure", "determine hiring needs", "design org chart", "calculate compensation", "plan equity a... | team, composition | team, composition, analysis, skill, should, used, user, asks, plan, structure, determine, hiring |

-## data-ai (91)
+## data-ai (92)

 | Skill | Description | Tags | Triggers |
 | --- | --- | --- | --- |
@@ -153,6 +153,7 @@ Total skills: 614
 | `fal-image-edit` | AI-powered image editing with style transfer and object removal | fal, image, edit | fal, image, edit, ai, powered, editing, style, transfer, object, removal |
 | `fal-upscale` | Upscale and enhance image and video resolution using AI | fal, upscale | fal, upscale, enhance, image, video, resolution, ai |
 | `fal-workflow` | Generate workflow JSON files for chaining AI models | fal | fal, generate, json, files, chaining, ai, models |
+| `fp-ts-react` | Practical patterns for using fp-ts with React - hooks, state, forms, data fetching. Use when building React apps with functional programming patterns. Works ... | fp, ts, react | fp, ts, react, practical, hooks, state, forms, data, fetching, building, apps, functional |
 | `frontend-dev-guidelines` | Opinionated frontend development standards for modern React + TypeScript applications. Covers Suspense-first data fetching, lazy loading, feature-based archi... | frontend, dev, guidelines | frontend, dev, guidelines, opinionated, development, standards, react, typescript, applications, covers, suspense, first |
 | `geo-fundamentals` | Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity). | geo, fundamentals | geo, fundamentals, generative, engine, optimization, ai, search, engines, chatgpt, claude, perplexity |
 | `graphql` | GraphQL gives clients exactly the data they need - no more, no less. One endpoint, typed schema, introspection. But the flexibility that makes it powerful al... | graphql | graphql, gives, clients, exactly, data, no, less, one, endpoint, typed, schema, introspection |
@@ -205,7 +206,7 @@ Total skills: 614
 | `xlsx` | Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work ... | xlsx | xlsx, spreadsheet, creation, editing, analysis, formulas, formatting, data, visualization, claude, work, spreadsheets |
 | `xlsx-official` | Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work ... | xlsx, official | xlsx, official, spreadsheet, creation, editing, analysis, formulas, formatting, data, visualization, claude, work |

-## development (78)
+## development (80)

 | Skill | Description | Tags | Triggers |
 | --- | --- | --- | --- |
@@ -232,6 +233,8 @@ Total skills: 614
 | `fastapi-pro` | Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROA... | fastapi | fastapi, pro, high, performance, async, apis, sqlalchemy, pydantic, v2, microservices, websockets, python |
 | `fastapi-templates` | Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applicati... | fastapi | fastapi, async, dependency, injection, error, handling, building, new, applications, setting, up, backend |
 | `firecrawl-scraper` | Deep web scraping, screenshots, PDF parsing, and website crawling using Firecrawl API | firecrawl, scraper | firecrawl, scraper, deep, web, scraping, screenshots, pdf, parsing, website, crawling, api |
+| `fp-ts-errors` | Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with f... | fp, ts, errors | fp, ts, errors, handle, values, either, taskeither, cleaner, predictable, typescript, code, implementing |
+| `fp-ts-pragmatic` | A practical, jargon-free guide to fp-ts functional programming - the 80/20 approach that gets results without the academic overhead. Use when writing TypeScr... | fp, ts, pragmatic | fp, ts, pragmatic, practical, jargon, free, functional, programming, 80, 20, approach, gets |
 | `frontend-design` | Create distinctive, production-grade frontend interfaces with intentional aesthetics, high craft, and non-generic visual identity. Use when building or styli... | frontend | frontend, distinctive, grade, interfaces, intentional, aesthetics, high, craft, non, generic, visual, identity |
 | `frontend-developer` | Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture... | frontend | frontend, developer, react, components, responsive, layouts, handle, client, side, state, masters, 19 |
 | `frontend-mobile-development-component-scaffold` | You are a React component architecture expert specializing in scaffolding production-ready, accessible, and performant components. Generate complete componen... | frontend, mobile, component | frontend, mobile, component, development, scaffold, react, architecture, specializing, scaffolding, accessible, performant, components |
--- a/FINAL_SKILLS_COUNT.md
+++ b/FINAL_SKILLS_COUNT.md
@@ -1,71 +0,0 @@
-# Conteggio Finale Skills da Committare
-
-**Data**: 2026-01-30  
-**Verifica**: Git Status
-
-## Risultato Verifica Git
-
-Dalla verifica dello stato git (`git status --porcelain`):
-
-### Skills Non Committate (Untracked - `??`)
-
-Tutte le skills con status `??` sono **nuove skills non ancora tracciate da git**.
-
-### Skills Modificate (Modified - ` M`)
-
-Skills esistenti che sono state modificate.
-
-## Breakdown Skills da VoltAgent
-
-### Fase 1: Skills Implementate Precedentemente (49 skills)
-Queste skills sono state implementate nella sessione precedente quando abbiamo analizzato VoltAgent per la prima volta.
-
-**Status**: Molte di queste sono già nel filesystem ma potrebbero non essere committate.
-
-### Fase 2: Skills Implementate Ora (12 skills)
-Queste sono le skills appena implementate dalla analisi delle skills con nomi simili:
-
-1. `frontend-slides`
-2. `linear-claude-skill`
-3. `skill-rails-upgrade`
-4. `context-fundamentals`
-5. `context-degradation`
-6. `context-compression`
-7. `context-optimization`
-8. `multi-agent-patterns`
-9. `tool-design`
-10. `evaluation`
-11. `memory-systems`
-12. `terraform-skill`
-
-## Totale Skills da Committare
-
-**Se fai commit e push ora, committeresti:**
-
- **Tutte le skills non tracciate** trovate da `git status` (status `??`)
- **Tutte le skills modificate** trovate da `git status` (status ` M`)
- **File di catalog aggiornati**: `data/catalog.json`, `data/skills_index.json`, `CATALOG.md`
- **File di attribuzione aggiornato**: `docs/SOURCES.md`
- **Scripts creati**: Vari script di analisi e implementazione
- **Report creati**: `VOLTAGENT_SYNC_REPORT.md`, `SIMILAR_SKILLS_ANALYSIS_REPORT.md`, `SIMILAR_SKILLS_IMPLEMENTATION_REPORT.md`, `HTML_CONVERSION_REPORT.md`
-
-## Nota Importante
-
-Il numero esatto di skills da committare dipende da:
-1. Quante delle 49 skills della Fase 1 sono già state committate in un commit precedente
-2. Quante sono ancora non committate
-
-**Per ottenere il numero esatto**, esegui:
-```bash
-git status --porcelain | grep "^??" | grep "skills/" | sed 's|^?? skills/||' | sed 's|/.*||' | sort | uniq | wc -l
-```
-
-Questo ti darà il numero preciso di **nuove skills** (cartelle) non committate.
-
-## Raccomandazione
-
-Prima di fare commit:
-1. ✅ Esegui `npm run chain` per validare e aggiornare i file generati
-2. ✅ Esegui `npm run catalog` per rigenerare il catalog
-3. ✅ Verifica che tutti i file generati siano inclusi nel commit
-4. ✅ Controlla che tutte le skills abbiano frontmatter corretto e "When to Use" section
--- a/HTML_CONVERSION_REPORT.md
+++ b/HTML_CONVERSION_REPORT.md
@@ -1,240 +0,0 @@
-# HTML to Markdown Conversion Report
-
-**Date**: 2026-01-30  
-**Skills Converted**: 24  
-**Status**: ✅ Completed Successfully
-
-## Executive Summary
-
-Successfully converted 24 skills from HTML content (GitHub page HTML) to clean markdown format. All skills now comply with the V4 Quality Bar standards and pass strict validation.
-
-### Conversion Statistics
-
- **Total skills converted**: 24
- **Success rate**: 100%
- **Method breakdown**:
-  - Raw download from GitHub: 19 skills (79%)
-  - HTML extraction: 5 skills (21%)
-  - Minimal content creation: 0 skills (fallback not needed)
-
-## Conversion Methods
-
-### Method 1: Raw Download (19 skills)
-
-Successfully downloaded raw markdown files directly from GitHub repositories:
-
- `commit` - Sentry commit conventions
- `automate-whatsapp` - WhatsApp automation
- `observe-whatsapp` - WhatsApp debugging
- `using-neon` - Neon Postgres best practices
- `screenshots` - Marketing screenshots with Playwright
- `n8n-node-configuration` - n8n node configuration
- `deep-research` - Gemini Deep Research Agent
- `imagen` - Google Gemini image generation
- `readme` - README generator
- `design-md` - Stitch DESIGN.md files
- `find-bugs` - Bug finding and security review
- `hugging-face-cli` - Hugging Face CLI operations
- `hugging-face-jobs` - Hugging Face compute jobs
- `n8n-code-python` - n8n Python coding
- `swiftui-expert-skill` - SwiftUI best practices
- `create-pr` - Sentry PR creation
- `vercel-deploy-claimable` - Vercel deployment
- `n8n-mcp-tools-expert` - n8n MCP tools
- `iterate-pr` - Sentry PR iteration
-
-**Process**: Constructed raw GitHub URLs from source URLs in frontmatter, downloaded markdown files, preserved frontmatter with correct metadata.
-
-### Method 2: HTML Extraction (5 skills)
-
-Extracted markdown content from GitHub HTML pages when raw files were not directly accessible:
-
- `culture-index` - Trail of Bits culture documentation indexing
- `expo-deployment` - Expo app deployment
- `fix-review` - Trail of Bits fix verification
- `sharp-edges` - Trail of Bits error-prone API identification
- `upgrading-expo` - Expo SDK upgrades
-
-**Process**: Extracted content from HTML structure, converted HTML elements to markdown, created appropriate content based on descriptions.
-
-**Note**: These 5 skills were later improved with manually created markdown content to ensure quality and completeness.
-
-## Corrections Applied
-
-### Frontmatter Fixes
-
-1. **Name Corrections**:
-   - `vercel-deploy-claimable`: Fixed name from "vercel-deploy" to "vercel-deploy-claimable"
-   - `using-neon`: Fixed name from "neon-postgres" to "using-neon"
-
-2. **Metadata Cleanup**:
-   - Removed unnecessary `metadata`, `author`, `version` fields where present
-   - Standardized to required fields: `name`, `description`, `source`, `risk`
-   - Added missing `risk: safe` to all skills
-
-### Content Improvements
-
-1. **Added "When to Use" Sections**:
-   - All 24 skills now have proper "## When to Use" sections
-   - Sections include clear trigger scenarios
-   - Based on skill descriptions and functionality
-
-2. **Content Quality**:
-   - Removed all HTML document structure (DOCTYPE, html, head, body tags)
-   - Removed GitHub navigation elements
-   - Removed GitHub asset links (CSS, JS)
-   - Preserved actual skill content and instructions
-
-## Validation Results
-
-All 24 converted skills pass strict validation:
-
- ✅ Valid frontmatter with required fields
- ✅ "When to Use" section present
- ✅ No HTML content (except in code blocks)
- ✅ Name matches folder name
- ✅ Risk level properly set
- ✅ Source attribution maintained
-
-## Skills Converted
-
-### Official Team Skills (19)
-
-#### Sentry (4)
- `commit` - Create commits with best practices
- `create-pr` - Create pull requests
- `find-bugs` - Find and identify bugs
- `iterate-pr` - Iterate on pull request feedback
-
-#### Trail of Bits (3)
- `culture-index` - Index and search culture documentation
- `fix-review` - Verify fix commits address audit findings
- `sharp-edges` - Identify error-prone APIs
-
-#### Expo (2)
- `expo-deployment` - Deploy Expo apps to production
- `upgrading-expo` - Upgrade Expo SDK versions
-
-#### Hugging Face (2)
- `hugging-face-cli` - HF Hub CLI operations
- `hugging-face-jobs` - Run compute jobs on HF infrastructure
-
-#### Other Official (8)
- `vercel-deploy-claimable` - Deploy projects to Vercel
- `design-md` - Create and manage DESIGN.md files
- `using-neon` - Neon Postgres best practices
- `n8n-code-python` - Python in n8n Code nodes
- `n8n-mcp-tools-expert` - n8n MCP tools guide
- `n8n-node-configuration` - n8n node configuration
- `swiftui-expert-skill` - SwiftUI best practices
- `deep-research` - Gemini Deep Research Agent
-
-### Community Skills (5)
-
- `automate-whatsapp` - Build WhatsApp automations
- `observe-whatsapp` - Debug WhatsApp delivery issues
- `readme` - Generate comprehensive project documentation
- `screenshots` - Generate marketing screenshots
- `imagen` - Generate images using Google Gemini
-
-## Files Created/Modified
-
-### Scripts Created
- `scripts/convert_html_to_markdown.py` - Main conversion script
- `scripts/check_html_content.py` - HTML content detection script
-
-### Skills Modified
- 24 skill files converted from HTML to markdown:
-  - All files in `skills/{skill-name}/SKILL.md`
-
-### Backup Created
- `skills_backup_html/` - Complete backup of original HTML content before conversion
-
-### Reports Generated
- `html_conversion_results.json` - Detailed conversion results
- `html_content_analysis.json` - HTML content analysis
- `HTML_CONVERSION_REPORT.md` - This report
-
-## Quality Assurance
-
-### Pre-Conversion
- ✅ Identified all skills with HTML content
- ✅ Created backups of original files
- ✅ Verified source URLs are accessible
-
-### Conversion Process
- ✅ Attempted raw download first (preferred method)
- ✅ Fallback to HTML extraction when needed
- ✅ Preserved frontmatter and metadata
- ✅ Maintained source attribution
-
-### Post-Conversion
- ✅ All skills pass `validate_skills.py --strict`
- ✅ No HTML content remaining (except in code blocks)
- ✅ All required sections present
- ✅ Frontmatter correctly formatted
- ✅ Names match folder names
-
-## Technical Details
-
-### HTML Detection
-
-Skills were identified as having HTML content if they contained:
- `<!DOCTYPE html>` declarations
- `<html>` tags
- GitHub asset links (`github.githubassets.com`)
- GitHub navigation elements
-
-### Conversion Process
-
-1. **Parse frontmatter** - Extract and preserve metadata
-2. **Build raw URL** - Convert GitHub tree/blob URLs to raw URLs
-3. **Download raw** - Attempt to download markdown file
-4. **Extract from HTML** - If raw unavailable, extract from HTML structure
-5. **Create minimal** - If extraction fails, create from description
-6. **Validate** - Ensure compliance with quality standards
-
-### URL Conversion Patterns
-
- `github.com/org/repo/tree/main/path` → `raw.githubusercontent.com/org/repo/main/path/SKILL.md`
- `github.com/org/repo/blob/main/path/SKILL.md` → `raw.githubusercontent.com/org/repo/main/path/SKILL.md`
-
-## Issues Resolved
-
-### Issue 1: HTML Content in Skills
-**Problem**: 24 skills contained full GitHub page HTML instead of markdown  
-**Solution**: Converted all HTML to clean markdown using multiple methods  
-**Status**: ✅ Resolved
-
-### Issue 2: Missing "When to Use" Sections
-**Problem**: Some downloaded raw files didn't have "When to Use" sections  
-**Solution**: Added appropriate "When to Use" sections to all skills  
-**Status**: ✅ Resolved
-
-### Issue 3: Frontmatter Name Mismatches
-**Problem**: Some skills had names in frontmatter that didn't match folder names  
-**Solution**: Corrected frontmatter names to match folder names  
-**Status**: ✅ Resolved
-
-### Issue 4: Missing Risk Labels
-**Problem**: Some skills were missing risk labels  
-**Solution**: Added `risk: safe` to all skills  
-**Status**: ✅ Resolved
-
-## Next Steps
-
-1. ✅ All conversions completed
-2. ✅ All validations passed
-3. ✅ Report generated
-4. ⏳ Ready for commit and push (awaiting user approval)
-
-## Conclusion
-
-Successfully converted all 24 skills from HTML to clean markdown format. All skills now:
- Comply with V4 Quality Bar standards
- Pass strict validation
- Have proper structure and formatting
- Maintain source attribution
- Are ready for use in the repository
-
-The conversion process was automated where possible, with manual improvements applied to ensure quality. All original content has been backed up for reference.
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-# 🌌 Antigravity Awesome Skills: 614+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
+# 🌌 Antigravity Awesome Skills: 624+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More

-> **The Ultimate Collection of 614+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode**
+> **The Ultimate Collection of 624+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode**

 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)
@@ -11,7 +11,7 @@
 [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode)
 [![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills)

-**Antigravity Awesome Skills** is a curated, battle-tested library of **614 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants:
+**Antigravity Awesome Skills** is a curated, battle-tested library of **624 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants:

 - 🟣 **Claude Code** (Anthropic CLI)
 - 🔵 **Gemini CLI** (Google DeepMind)
@@ -29,7 +29,7 @@ This repository provides essential skills to transform your AI assistant into a
 - [🔌 Compatibility & Invocation](#compatibility--invocation)
 - [📦 Features & Categories](#features--categories)
 - [🎁 Curated Collections (Bundles)](#curated-collections)
- [📚 Browse 614+ Skills](#browse-614-skills)
+- [📚 Browse 624+ Skills](#browse-624-skills)
 - [🛠️ Installation](#installation)
 - [🤝 How to Contribute](#how-to-contribute)
 - [👥 Contributors & Credits](#credits--sources)
@@ -52,7 +52,7 @@ AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **speci

 ### 2. ⚡️ Quick Start (The "Bundle" Way)

-Don't install 614+ skills manually. Use our **Starter Packs**:
+Don't install 624+ skills manually. Use our **Starter Packs**:

 1.  **Install** (pick one):
    ```bash
@@ -124,7 +124,7 @@ The repository is organized into specialized domains to transform your AI into a

 [Check out our Starter Packs in docs/BUNDLES.md](docs/BUNDLES.md) to find the perfect toolkit for your role.

-## Browse 614+ Skills
+## Browse 624+ Skills

 We have moved the full skill registry to a dedicated catalog to keep this README clean.

@@ -223,6 +223,7 @@ This collection would not be possible without the incredible work of the Claude
 - **[zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide)**: Comprehensive Security suite & Guide (Source for ~60 new skills).
 - **[alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)**: Senior Engineering and PM toolkit.
 - **[karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills)**: A massive list of verified skills for Claude Code.
+- **[VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)**: Curated collection of 61 high-quality skills including official team skills from Sentry, Trail of Bits, Expo, Hugging Face, and comprehensive context engineering suite (v4.3.0 integration).
 - **[zircote/.claude](https://github.com/zircote/.claude)**: Shopify development skill reference.
 - **[vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills)**: AI Agents, Integrations, Maker Tools (57 skills, Apache 2.0).
 - **[coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)**: Marketing skills for CRO, copywriting, SEO, paid ads, and growth (23 skills, MIT).
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -1,3 +1,23 @@
+# Release v4.4.0: fp-ts skills for TypeScript
+
+> **Three practical fp-ts skills for TypeScript functional programming**
+
+This release adds 3 fp-ts skills sourced from [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills), bringing the total to 624 skills. These skills focus on practical, jargon-free patterns for pipe, Option, Either, TaskEither, React integration, and type-safe error handling.
+
+## New Skills (3)
+
+- **[fp-ts-pragmatic](skills/fp-ts-pragmatic/)** – The 80/20 of functional programming: pipe, Option, Either, TaskEither without academic jargon
+- **[fp-ts-react](skills/fp-ts-react/)** – Patterns for using fp-ts with React 18/19 and Next.js 14/15 (state, forms, data fetching)
+- **[fp-ts-errors](skills/fp-ts-errors/)** – Type-safe error handling with Either and TaskEither; no more try/catch spaghetti
+
+## Registry Update
+
+- **Total Skills**: 624 (from 621)
+- **New Skills Added**: 3
+- **Catalog**: Regenerated with all skills
+
+---
+
 # Release v4.3.0: VoltAgent Integration & Context Engineering Suite

 > **Massive expansion with 61 new skills from VoltAgent repository, including official team skills and comprehensive context engineering capabilities**
--- a/SIMILAR_SKILLS_ANALYSIS_REPORT.md
+++ b/SIMILAR_SKILLS_ANALYSIS_REPORT.md
@@ -1,186 +0,0 @@
-# Analisi delle 65 Skills con Nomi Simili
-
-**Data**: 2026-01-30  
-**Skills Analizzate**: 89 totali (di cui 49 già implementate)  
-**Rimanenti da Analizzare**: 40 skills
-
-## Executive Summary
-
-Delle 89 skills con nomi simili identificate inizialmente:
- ✅ **49 già implementate** (dalle 24 convertite da HTML + 25 altre)
- ❌ **2 duplicate** (già esistono nella repository)
- ⚠️ **13 necessitano revisione** (hanno fonti valide, potrebbero essere nuove o duplicate)
- ❌ **74 hanno fonti non valide** (URL non accessibili o SKILL.md non trovato)
-
-## Skills Duplicate (2)
-
-Queste skills **NON devono essere aggiunte** perché esistono già nella repository:
-
-1. **`react-best-practices`** (vercel-labs)
-   - Esiste già: `skills/react-best-practices/` o simile
-   - URL: https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices
-
-2. **`postgres-best-practices`** (supabase)
-   - Esiste già: `skills/postgres-best-practices/` o `skills/supabase-postgres-best-practices/`
-   - URL: https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices
-
-## Skills che Necessitano Revisione (13)
-
-Queste skills hanno **fonti valide** (SKILL.md accessibile) ma richiedono una valutazione manuale per determinare se sono:
- **Nuove e complementari** → Da aggiungere
- **Duplicate** → Da scartare
-
-### 1. Skills Potenzialmente Duplicate (da verificare)
-
-#### `notebooklm-skill` (PleasePrompto)
- **Descrizione**: Interact with NotebookLM for document-based conversations
- **URL**: https://github.com/PleasePrompto/notebooklm-skill
- **Raw URL**: https://github.com/PleasePrompto/notebooklm-skill/raw/master/SKILL.md
- **Skills simili esistenti**: `notebooklm`
- **Raccomandazione**: ⚠️ **Verificare** se è diverso da `notebooklm` esistente. Se è solo una versione alternativa, scartare.
-
-#### `evaluation` (muratcankoylan)
- **Descrizione**: Build evaluation frameworks for agent systems
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/evaluation
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Skills simili esistenti**: `agent-evaluation`, `llm-evaluation`
- **Raccomandazione**: ⚠️ **Verificare** se è complementare o duplicato. Se copre solo evaluation generale, potrebbe essere duplicato.
-
-#### `memory-systems` (muratcankoylan)
- **Descrizione**: Design short-term, long-term, and graph-based memory architectures
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/memory-systems
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Skills simili esistenti**: `agent-memory-systems`
- **Raccomandazione**: ⚠️ **Verificare** se è complementare o duplicato. Se è solo un nome alternativo, scartare.
-
-#### `terraform-skill` (antonbabenko)
- **Descrizione**: Terraform infrastructure as code best practices
- **URL**: https://github.com/antonbabenko/terraform-skill
- **Raw URL**: https://github.com/antonbabenko/terraform-skill/raw/master/SKILL.md
- **Skills simili esistenti**: `terraform-specialist`, `terraform-module-library`
- **Raccomandazione**: ⚠️ **Verificare** se aggiunge valore rispetto a `terraform-specialist`. Se è solo best practices generiche, potrebbe essere duplicato.
-
-### 2. Skills Probabilmente Nuove e Complementari (da aggiungere)
-
-#### `frontend-slides` (zarazhangrui)
- **Descrizione**: Generate animation-rich HTML presentations with visual style previews
- **URL**: https://github.com/zarazhangrui/frontend-slides
- **Raw URL**: https://github.com/zarazhangrui/frontend-slides/raw/main/SKILL.md
- **Skills simili esistenti**: `frontend-patterns`, `frontend-design`
- **Raccomandazione**: ✅ **Aggiungere** - Focus specifico su presentazioni HTML animate, complementare a frontend-design.
-
-#### `linear-claude-skill` (wrsmith108)
- **Descrizione**: Manage Linear issues, projects, and teams
- **URL**: https://github.com/wrsmith108/linear-claude-skill
- **Raw URL**: https://github.com/wrsmith108/linear-claude-skill/raw/main/SKILL.md
- **Skills simili esistenti**: Nessuna skill Linear esistente
- **Raccomandazione**: ✅ **Aggiungere** - Skill completamente nuova per integrazione Linear.
-
-#### `skill-rails-upgrade` (robzolkos)
- **Descrizione**: Analyze Rails apps and provide upgrade assessments
- **URL**: https://github.com/robzolkos/skill-rails-upgrade
- **Raw URL**: https://github.com/robzolkos/skill-rails-upgrade/raw/master/SKILL.md
- **Skills simili esistenti**: Nessuna skill Rails upgrade esistente
- **Raccomandazione**: ✅ **Aggiungere** - Skill specifica per upgrade Rails, complementare a `ruby-pro`.
-
-#### Context Engineering Skills (muratcankoylan) - 4 skills
-
-Queste 4 skills fanno parte di una suite di Context Engineering e sembrano complementari:
-
-##### `context-fundamentals`
- **Descrizione**: Understand what context is, why it matters, and the anatomy of context in agent systems
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-fundamentals
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Raccomandazione**: ✅ **Aggiungere** - Fondamentali di context engineering, complementare a `context-manager`.
-
-##### `context-degradation`
- **Descrizione**: Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-degradation
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Raccomandazione**: ✅ **Aggiungere** - Pattern specifici di degradazione del context, complementare.
-
-##### `context-compression`
- **Descrizione**: Design and evaluate compression strategies for long-running sessions
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-compression
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Raccomandazione**: ✅ **Aggiungere** - Strategie di compressione del context, complementare.
-
-##### `context-optimization`
- **Descrizione**: Apply compaction, masking, and caching strategies
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-optimization
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Raccomandazione**: ✅ **Aggiungere** - Ottimizzazione del context, complementare.
-
-#### `multi-agent-patterns` (muratcankoylan)
- **Descrizione**: Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/multi-agent-patterns
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Skills simili esistenti**: `agent-manager-skill`, `computer-use-agents`
- **Raccomandazione**: ✅ **Aggiungere** - Pattern architetturali multi-agent, complementare a `autonomous-agents`.
-
-#### `tool-design` (muratcankoylan)
- **Descrizione**: Build tools that agents can use effectively, including architectural reduction patterns
- **URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design
- **Raw URL**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md
- **Skills simili esistenti**: Nessuna skill tool-design esistente
- **Raccomandazione**: ✅ **Aggiungere** - Design di tool per agenti, complementare a `agent-tool-builder`.
-
-## Skills con Fonti Non Valide (74)
-
-Queste skills hanno **URL non accessibili** o **SKILL.md non trovato**. Non possono essere implementate senza accesso al contenuto.
-
-### Categorie di Skills Non Valide
-
-#### Official Team Skills (molte da Cloudflare, Hugging Face, Stripe, Trail of Bits, Expo, Sentry)
- Skills ufficiali di team che potrebbero non avere SKILL.md pubblici o potrebbero essere in percorsi diversi
- Esempi: `building-ai-agent-on-cloudflare`, `hugging-face-datasets`, `stripe-best-practices`, `burpsuite-project-parser`, etc.
-
-#### Community Skills
- Skills della community con URL non validi o repository non più disponibili
-
-**Raccomandazione**: ⏸️ **Non implementare** senza accesso al contenuto. Se necessario, contattare i maintainer o verificare manualmente i repository.
-
-## Raccomandazioni Finali
-
-### ✅ Da Implementare (9 skills)
-
-1. `frontend-slides` - Presentazioni HTML animate
-2. `linear-claude-skill` - Integrazione Linear
-3. `skill-rails-upgrade` - Upgrade Rails
-4. `context-fundamentals` - Fondamentali context engineering
-5. `context-degradation` - Pattern di degradazione context
-6. `context-compression` - Compressione context
-7. `context-optimization` - Ottimizzazione context
-8. `multi-agent-patterns` - Pattern multi-agent
-9. `tool-design` - Design tool per agenti
-
-### ⚠️ Da Verificare Manualmente (4 skills)
-
-1. `notebooklm-skill` - Verificare se diverso da `notebooklm` esistente
-2. `evaluation` - Verificare se complementare a `agent-evaluation`/`llm-evaluation`
-3. `memory-systems` - Verificare se diverso da `agent-memory-systems`
-4. `terraform-skill` - Verificare se aggiunge valore rispetto a `terraform-specialist`
-
-### ❌ Da Scartare (2 skills)
-
-1. `react-best-practices` - Duplicato
-2. `postgres-best-practices` - Duplicato
-
-### ⏸️ Non Implementabili (74 skills)
-
-Skills con fonti non valide - richiederebbero accesso manuale ai repository o contatto con i maintainer.
-
-## Prossimi Passi
-
-1. **Implementare le 9 skills raccomandate** seguendo il processo standard
-2. **Verificare manualmente le 4 skills** confrontando con quelle esistenti
-3. **Scartare le 2 duplicate**
-4. **Documentare le 74 skills non valide** per riferimento futuro
-
-## Statistiche Finali
-
- **Total skills analizzate**: 89
- **Già implementate**: 49
- **Nuove da aggiungere**: 9-13 (dipende dalla verifica manuale)
- **Duplicate**: 2
- **Non implementabili**: 74
--- a/SIMILAR_SKILLS_IMPLEMENTATION_REPORT.md
+++ b/SIMILAR_SKILLS_IMPLEMENTATION_REPORT.md
@@ -1,158 +0,0 @@
-# Report Implementazione Skills con Nomi Simili
-
-**Data**: 2026-01-30  
-**Skills Implementate**: 12  
-**Status**: ✅ Completato con Successo
-
-## Executive Summary
-
-Successfully implemented **12 new skills** from the similar skills analysis:
- 9 skills raccomandate come nuove e complementari
- 3 skills verificate manualmente come complementari (evaluation, memory-systems, terraform-skill)
- 1 skill duplicata scartata (notebooklm-skill - identica a notebooklm esistente)
-
-## Skills Implementate
-
-### 1. frontend-slides (zarazhangrui)
- **Descrizione**: Generate animation-rich HTML presentations with visual style previews
- **Source**: https://github.com/zarazhangrui/frontend-slides
- **Categoria**: Community Skills
- **Status**: ✅ Implementata
-
-### 2. linear-claude-skill (wrsmith108)
- **Descrizione**: Manage Linear issues, projects, and teams
- **Source**: https://github.com/wrsmith108/linear-claude-skill
- **Categoria**: Community Skills
- **Status**: ✅ Implementata
-
-### 3. skill-rails-upgrade (robzolkos)
- **Descrizione**: Analyze Rails apps and provide upgrade assessments
- **Source**: https://github.com/robzolkos/skill-rails-upgrade
- **Categoria**: Community Skills
- **Status**: ✅ Implementata
-
-### 4-7. Context Engineering Skills (muratcankoylan)
-Quattro skills complementari per context engineering:
-
-#### context-fundamentals
- **Descrizione**: Understand what context is, why it matters, and the anatomy of context in agent systems
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Status**: ✅ Implementata
-
-#### context-degradation
- **Descrizione**: Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Status**: ✅ Implementata
-
-#### context-compression
- **Descrizione**: Design and evaluate compression strategies for long-running sessions
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Status**: ✅ Implementata
-
-#### context-optimization
- **Descrizione**: Apply compaction, masking, and caching strategies
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Status**: ✅ Implementata
-
-### 8. multi-agent-patterns (muratcankoylan)
- **Descrizione**: Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Categoria**: Community Skills
- **Status**: ✅ Implementata
-
-### 9. tool-design (muratcankoylan)
- **Descrizione**: Build tools that agents can use effectively, including architectural reduction patterns
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Categoria**: Community Skills
- **Status**: ✅ Implementata
-
-### 10. evaluation (muratcankoylan) - Verificata
- **Descrizione**: Build evaluation frameworks for agent systems
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Categoria**: Community Skills
- **Status**: ✅ Implementata (complementare a agent-evaluation e llm-evaluation)
-
-### 11. memory-systems (muratcankoylan) - Verificata
- **Descrizione**: Design short-term, long-term, and graph-based memory architectures
- **Source**: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering
- **Categoria**: Community Skills
- **Status**: ✅ Implementata (complementare a agent-memory-systems)
-
-### 12. terraform-skill (antonbabenko) - Verificata
- **Descrizione**: Terraform infrastructure as code best practices
- **Source**: https://github.com/antonbabenko/terraform-skill
- **Categoria**: Community Skills
- **Status**: ✅ Implementata (complementare a terraform-specialist)
-
-## Skills Scartate
-
-### notebooklm-skill (PleasePrompto) - Duplicato
- **Motivo**: Identica a `notebooklm` esistente nella repository
- **Confronto**: Stesso contenuto, stesso frontmatter name, stessa funzionalità
- **Decisione**: ❌ Scartata come duplicato
-
-## Processo di Implementazione
-
-### Fase 1: Verifica Manuale delle Skills Incerte
- Verificate 4 skills che necessitavano revisione manuale
- `notebooklm-skill`: Identificata come duplicato esatto
- `evaluation`: Verificata come complementare (più generale di agent-evaluation/llm-evaluation)
- `memory-systems`: Verificata come complementare (più dettagliata di agent-memory-systems)
- `terraform-skill`: Verificata come complementare (più pratica di terraform-specialist)
-
-### Fase 2: Download e Implementazione
- Creato script `scripts/implement_similar_skills.py` per automatizzare il processo
- Download di SKILL.md da repository GitHub
- Verifica compliance con frontmatter standard
- Aggiunta sezione "When to Use" dove mancante
- Gestione speciale per `frontend-slides` (download manuale con curl)
-
-### Fase 3: Validazione
- Tutte le 12 skills passano la validazione di compliance
- Frontmatter completo con: name, description, source, risk
- Sezione "When to Use" presente in tutte
- Contenuto markdown pulito (nessun HTML)
-
-### Fase 4: Aggiornamento Cataloghi
- Aggiornato `data/catalog.json`: 614 skills totali (da 602)
- Aggiornato `data/skills_index.json`
- Aggiornato `CATALOG.md`
- Aggiornato `docs/SOURCES.md` con attribuzioni
-
-## Statistiche Finali
-
- **Total skills analizzate**: 89 (con nomi simili)
- **Skills già implementate**: 49 (dalla fase precedente)
- **Skills duplicate scartate**: 3 (react-best-practices, postgres-best-practices, notebooklm-skill)
- **Skills nuove implementate**: 12
- **Skills con fonti non valide**: 74 (non implementabili)
-
-## Totale Skills Nuove da VoltAgent
-
- **Fase precedente**: 49 skills implementate
- **Fase corrente**: 12 skills implementate
- **TOTALE**: **61 skills nuove** aggiunte dalla repository VoltAgent
-
-## Qualità e Compliance
-
-Tutte le 12 skills implementate:
- ✅ Frontmatter completo e corretto
- ✅ Sezione "When to Use" presente
- ✅ Source attribution corretta
- ✅ Risk level impostato
- ✅ Contenuto markdown pulito
- ✅ Nome corrisponde al nome della cartella
-
-## Prossimi Passi
-
-1. ✅ Tutte le skills implementate
-2. ✅ Cataloghi aggiornati
-3. ✅ Attribuzioni aggiunte
-4. ⏳ Pronto per commit e push (in attesa di approvazione utente)
-
-## Note Tecniche
-
- `frontend-slides` ha richiesto download manuale con curl a causa di problemi con lo script Python
- Tutte le altre skills sono state scaricate automaticamente dallo script
- Le skills di Context Engineering (muratcankoylan) sono parte di una suite coerente
- Le skills verificate manualmente sono risultate complementari, non duplicate
--- a/VOLTAGENT_SYNC_REPORT.md
+++ b/VOLTAGENT_SYNC_REPORT.md
@@ -1,215 +0,0 @@
-# VoltAgent Skills Sync Report
-
-**Date**: 2026-01-30  
-**Source Repository**: [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)  
-**Target Repository**: antigravity-awesome-skills
-
-## Executive Summary
-
-Successfully analyzed the VoltAgent/awesome-agent-skills repository and implemented **49 new validated skills** into the antigravity-awesome-skills collection.
-
-### Statistics
-
- **Total skills analyzed**: 174
- **Skills already present**: 32
- **New skills identified**: 53
- **Skills validated**: 49
- **Skills implemented**: 49
- **Skills failed validation**: 4
- **Skills with similar names** (potential duplicates): 89
-
-## Implementation Process
-
-### Phase 1: Analysis ✅
-
-Created `scripts/analyze_voltagent_repo.py` to:
- Fetch and parse the VoltAgent README.md
- Extract all skill references (format: `**[org/skill-name](url)**`)
- Normalize skill names to kebab-case
- Compare with existing skills in `data/catalog.json`
-
-**Result**: Identified 53 new skills not present in the current collection.
-
-### Phase 2: Source Validation ✅
-
-Created `scripts/validate_voltagent_sources.py` to:
- Verify GitHub URL accessibility
- Check for SKILL.md file presence
- Validate license compatibility
- Identify official vs community skills
-
-**Result**: 
- ✅ 49 skills validated successfully
- ❌ 4 skills failed (URL 404 errors)
-
-### Phase 3: Implementation ✅
-
-Created `scripts/implement_voltagent_skills.py` to:
- Download SKILL.md files from GitHub repositories
- Ensure frontmatter compliance (name, description, source, risk)
- Add "When to Use" sections where missing
- Create minimal SKILL.md for skills without downloadable files
-
-**Result**: All 49 validated skills successfully implemented.
-
-### Phase 4: Catalog Update ✅
-
- Updated `data/skills_index.json`: 609 skills total
- Updated `data/catalog.json`: 602 skills total
- Updated `CATALOG.md`: Regenerated catalog documentation
- Updated `docs/SOURCES.md`: Added attributions for all new skills
-
-## Implemented Skills
-
-### Official Team Skills (27)
-
-#### Vercel Labs (1)
- `vercel-deploy-claimable` - Deploy projects to Vercel
-
-#### Google Labs / Stitch (1)
- `design-md` - Create and manage DESIGN.md files
-
-#### Hugging Face (2)
- `hugging-face-cli` - HF Hub CLI for models, datasets, repos, and compute jobs
- `hugging-face-jobs` - Run compute jobs and Python scripts on HF infrastructure
-
-#### Trail of Bits (3)
- `culture-index` - Index and search culture documentation
- `fix-review` - Verify fix commits address audit findings without new bugs
- `sharp-edges` - Identify error-prone APIs and dangerous configurations
-
-#### Expo (2)
- `expo-deployment` - Deploy Expo apps to production
- `upgrading-expo` - Upgrade Expo SDK versions
-
-#### Sentry (4)
- `commit` - Create commits with best practices
- `create-pr` - Create pull requests
- `find-bugs` - Find and identify bugs in code
- `iterate-pr` - Iterate on pull request feedback
-
-#### Neon (1)
- `using-neon` - Best practices for Neon Serverless Postgres
-
-#### fal.ai Community (6)
- `fal-audio` - Text-to-speech and speech-to-text using fal.ai audio models
- `fal-generate` - Generate images and videos using fal.ai AI models
- `fal-image-edit` - AI-powered image editing with style transfer and object removal
- `fal-platform` - Platform APIs for model management, pricing, and usage tracking
- `fal-upscale` - Upscale and enhance image and video resolution using AI
- `fal-workflow` - Generate workflow JSON files for chaining AI models
-
-### Community Skills (22)
-
-#### WhatsApp Automation (2)
- `automate-whatsapp` - Build WhatsApp automations with workflows and agents
- `observe-whatsapp` - Debug WhatsApp delivery issues and run health checks
-
-#### Development Tools (8)
- `readme` - Generate comprehensive project documentation
- `screenshots` - Generate marketing screenshots with Playwright
- `aws-skills` - AWS development with infrastructure automation and cloud architecture patterns
- `deep-research` - Autonomous multi-step research using Gemini Deep Research Agent
- `ffuf-claude-skill` - Web fuzzing with ffuf
- `ui-skills` - Opinionated, evolving constraints to guide agents when building interfaces
- `vexor` - Vector-powered CLI for semantic file search
- `pypict-skill` - Pairwise test generation
-
-#### Platform-Specific (3)
- `makepad-skills` - Makepad UI development skills for Rust apps
- `swiftui-expert-skill` - Modern SwiftUI best practices and iOS 26+ Liquid Glass adoption
- `threejs-skills` - Three.js skills for creating 3D elements and interactive experiences
-
-#### Specialized Domains (9)
- `claude-scientific-skills` - Scientific research and analysis skills
- `claude-win11-speckit-update-skill` - Windows 11 system management
- `imagen` - Generate images using Google Gemini's API
- `security-bluebook-builder` - Build security Blue Books for sensitive apps
- `claude-ally-health` - Health assistant skill for medical information analysis
- `clarity-gate` - Pre-ingestion verification for epistemic quality in RAG systems
- `n8n-code-python` - Python coding in n8n Code nodes with limitations
- `n8n-mcp-tools-expert` - MCP tools guide with tool selection and node formats
- `n8n-node-configuration` - Node configuration with dependency rules and AI connections
-
-#### Utilities (3)
- `varlock-claude-skill` - Secure environment variable management
- `beautiful-prose` - Hard-edged writing style contract for timeless, forceful English prose
- `claude-speed-reader` - Speed read Claude's responses at 600+ WPM using RSVP
- `skill-seekers` - Automatically convert documentation websites, GitHub repositories, and PDFs into Claude AI skills
-
-## Failed Validations
-
-The following skills failed validation due to inaccessible URLs (HTTP 404):
-
-1. `agents-sdk` (cloudflare) - URL not accessible
-2. `wrangler` (cloudflare) - URL not accessible  
-3. `claudisms` (jeffersonwarrior) - URL not accessible
-4. `defense-in-depth` (obra) - URL not accessible
-
-**Note**: These skills may be available at different URLs or may have been moved/removed from their original repositories.
-
-## Skills with Similar Names
-
-89 skills were identified with similar names to existing skills. These were flagged for manual review to avoid duplicates:
-
- `template` (similar to: defi-protocol-templates, documentation-templates)
- `react-best-practices` (similar to: vercel-react-best-practices)
- `react-native-skills` (similar to: various React Native skills)
- `postgres-best-practices` (similar to: postgresql, postgres-best-practices)
- And 85 more...
-
-**Action**: These require manual review to determine if they are duplicates or complementary skills.
-
-## Quality Assurance
-
-### Validation Status
-
-All implemented skills include:
- ✅ Valid YAML frontmatter with required fields (name, description, source, risk)
- ✅ "When to Use" section
- ✅ Proper attribution to source repositories
- ✅ Risk level classification (default: safe)
-
-### Known Issues
-
-Some skills were downloaded with HTML content instead of markdown due to GitHub URL structure. These files have:
- ✅ Correct frontmatter
- ✅ "When to Use" section
- ⚠️ HTML content that may need manual cleanup
-
-**Affected skills**: Skills from fal.ai community and some community repositories.
-
-## Files Created/Modified
-
-### Scripts Created
- `scripts/analyze_voltagent_repo.py` - Analysis script
- `scripts/validate_voltagent_sources.py` - Source validation script
- `scripts/implement_voltagent_skills.py` - Implementation script
-
-### Data Files Updated
- `data/catalog.json` - Updated with new skills
- `data/skills_index.json` - Updated index
- `CATALOG.md` - Regenerated catalog
- `docs/SOURCES.md` - Added attributions
-
-### Analysis Files Generated
- `voltagent_analysis.json` - Detailed analysis results
- `voltagent_validation.json` - Validation results
-
-### Skills Added
-49 new skill directories in `skills/`:
- See "Implemented Skills" section above for complete list
-
-## Next Steps
-
-1. **Manual Review**: Review skills with similar names to identify duplicates
-2. **Content Cleanup**: Clean up HTML content in skills that were downloaded incorrectly
-3. **Testing**: Test new skills to ensure they work correctly
-4. **Documentation**: Update any additional documentation as needed
-5. **Follow-up**: Monitor for updates to failed validations (agents-sdk, wrangler, etc.)
-
-## Conclusion
-
-Successfully integrated 49 new high-quality skills from the VoltAgent curated collection, significantly expanding the antigravity-awesome-skills repository. All skills follow the V4 Quality Bar standards and are properly attributed to their original sources.
-
-The collection now includes skills from major development teams (Vercel, Google, Hugging Face, Trail of Bits, Expo, Sentry, Neon) as well as valuable community contributions, making it an even more comprehensive resource for AI coding assistants.
--- a/data/aliases.json
+++ b/data/aliases.json
@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-01-30T08:15:03.985Z",
+  "generatedAt": "2026-01-30T19:29:11.960Z",
  "aliases": {
    "accessibility-compliance-audit": "accessibility-compliance-accessibility-audit",
    "active directory attacks": "active-directory-attacks",
--- a/data/bundles.json
+++ b/data/bundles.json
@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-01-30T08:15:03.985Z",
+  "generatedAt": "2026-01-30T19:29:11.960Z",
  "bundles": {
    "core-dev": {
      "description": "Core development skills across languages, frameworks, and backend/frontend fundamentals.",
@@ -45,6 +45,9 @@
        "firebase",
        "firecrawl-scraper",
        "flutter-expert",
+        "fp-ts-errors",
+        "fp-ts-pragmatic",
+        "fp-ts-react",
        "frontend-design",
        "frontend-dev-guidelines",
        "frontend-developer",
@@ -276,6 +279,7 @@
        "database-optimizer",
        "dbt-transformation-patterns",
        "firebase",
+        "fp-ts-react",
        "frontend-dev-guidelines",
        "gdpr-data-handling",
        "graphql",
--- a/data/catalog.json
+++ b/data/catalog.json
@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-01-30T08:15:03.985Z",
-  "total": 614,
+  "generatedAt": "2026-01-30T19:29:11.960Z",
+  "total": 617,
  "skills": [
    {
      "id": "3d-web-experience",
@@ -5873,6 +5873,84 @@
      ],
      "path": "skills/form-cro/SKILL.md"
    },
+    {
+      "id": "fp-ts-errors",
+      "name": "fp-ts-errors",
+      "description": "Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.",
+      "category": "development",
+      "tags": [
+        "fp",
+        "ts",
+        "errors"
+      ],
+      "triggers": [
+        "fp",
+        "ts",
+        "errors",
+        "handle",
+        "values",
+        "either",
+        "taskeither",
+        "cleaner",
+        "predictable",
+        "typescript",
+        "code",
+        "implementing"
+      ],
+      "path": "skills/fp-ts-errors/SKILL.md"
+    },
+    {
+      "id": "fp-ts-pragmatic",
+      "name": "fp-ts-pragmatic",
+      "description": "A practical, jargon-free guide to fp-ts functional programming - the 80/20 approach that gets results without the academic overhead. Use when writing TypeScript with fp-ts library.",
+      "category": "development",
+      "tags": [
+        "fp",
+        "ts",
+        "pragmatic"
+      ],
+      "triggers": [
+        "fp",
+        "ts",
+        "pragmatic",
+        "practical",
+        "jargon",
+        "free",
+        "functional",
+        "programming",
+        "80",
+        "20",
+        "approach",
+        "gets"
+      ],
+      "path": "skills/fp-ts-pragmatic/SKILL.md"
+    },
+    {
+      "id": "fp-ts-react",
+      "name": "fp-ts-react",
+      "description": "Practical patterns for using fp-ts with React - hooks, state, forms, data fetching. Use when building React apps with functional programming patterns. Works with React 18/19, Next.js 14/15.",
+      "category": "data-ai",
+      "tags": [
+        "fp",
+        "ts",
+        "react"
+      ],
+      "triggers": [
+        "fp",
+        "ts",
+        "react",
+        "practical",
+        "hooks",
+        "state",
+        "forms",
+        "data",
+        "fetching",
+        "building",
+        "apps",
+        "functional"
+      ],
+      "path": "skills/fp-ts-react/SKILL.md"
+    },
    {
      "id": "framework-migration-code-migrate",
      "name": "framework-migration-code-migrate",
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
  "name": "antigravity-awesome-skills",
-  "version": "4.3.0",
-  "description": "614+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
+  "version": "4.4.0",
+  "description": "624+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
  "license": "MIT",
  "scripts": {
    "validate": "python3 scripts/validate_skills.py",
--- a/remaining_similar_skills.json
+++ b/remaining_similar_skills.json
--- a/scripts/analyze_remaining_similar_skills.py
+++ b/scripts/analyze_remaining_similar_skills.py
@@ -1,215 +0,0 @@
-#!/usr/bin/env python3
-"""
-Analyze remaining similar skills to determine if they are truly new
-and worth adding to the repository.
-"""
-
-import json
-import re
-from pathlib import Path
-from typing import Dict, List, Tuple
-from urllib.parse import urlparse
-from urllib.request import urlopen, Request
-from urllib.error import URLError, HTTPError
-
-def normalize_skill_name(name: str) -> str:
-    """Normalize skill name to kebab-case."""
-    # Remove special chars, convert to lowercase, replace spaces/hyphens
-    name = re.sub(r'[^\w\s-]', '', name.lower())
-    name = re.sub(r'[\s_]+', '-', name)
-    name = re.sub(r'-+', '-', name)
-    return name.strip('-')
-
-def check_url_accessible(url: str) -> bool:
-    """Check if URL is accessible."""
-    try:
-        req = Request(url, method='HEAD')
-        with urlopen(req, timeout=10) as response:
-            return response.status == 200
-    except (URLError, HTTPError, Exception):
-        return False
-
-def get_repo_base_url(github_url: str) -> str:
-    """Extract base GitHub repository URL."""
-    # Handle various GitHub URL formats
-    patterns = [
-        r'https://github\.com/([^/]+/[^/]+)',
-        r'github\.com/([^/]+/[^/]+)',
-    ]
-    
-    for pattern in patterns:
-        match = re.search(pattern, github_url)
-        if match:
-            return f"https://github.com/{match.group(1)}"
-    return None
-
-def check_skill_file_exists(repo_url: str, skill_path: str = None) -> Tuple[bool, str]:
-    """Check if SKILL.md exists in the repository."""
-    base_url = get_repo_base_url(repo_url)
-    if not base_url:
-        return False, None
-    
-    # Common paths to check
-    paths_to_check = [
-        f"{base_url}/raw/main/{skill_path}/SKILL.md" if skill_path else f"{base_url}/raw/main/SKILL.md",
-        f"{base_url}/raw/main/skills/{skill_path}/SKILL.md" if skill_path else None,
-        f"{base_url}/raw/master/{skill_path}/SKILL.md" if skill_path else f"{base_url}/raw/master/SKILL.md",
-        f"{base_url}/blob/main/{skill_path}/SKILL.md" if skill_path else f"{base_url}/blob/main/SKILL.md",
-    ]
-    
-    for path in paths_to_check:
-        if path and check_url_accessible(path):
-            return True, path
-    
-    return False, None
-
-def analyze_similarity(skill_name: str, similar_skills: List[str], existing_skills: Dict) -> Dict:
-    """Analyze how similar a skill is to existing ones."""
-    analysis = {
-        'is_duplicate': False,
-        'is_complementary': False,
-        'similarity_score': 0.0,
-        'closest_match': None,
-        'reasoning': []
-    }
-    
-    skill_lower = skill_name.lower()
-    
-    # Check for exact or near-exact matches
-    for existing_name, existing_data in existing_skills.items():
-        existing_lower = existing_name.lower()
-        
-        # Exact match
-        if skill_lower == existing_lower:
-            analysis['is_duplicate'] = True
-            analysis['closest_match'] = existing_name
-            analysis['reasoning'].append(f"Exact match with existing skill: {existing_name}")
-            return analysis
-        
-        # Check if one contains the other
-        if skill_lower in existing_lower or existing_lower in skill_lower:
-            if abs(len(skill_lower) - len(existing_lower)) <= 3:
-                analysis['is_duplicate'] = True
-                analysis['closest_match'] = existing_name
-                analysis['similarity_score'] = 0.9
-                analysis['reasoning'].append(f"Near-exact match: '{skill_name}' vs '{existing_name}'")
-                return analysis
-    
-    # Check similarity with similar skills list
-    for similar in similar_skills:
-        if similar.lower() in existing_skills:
-            existing_data = existing_skills[similar.lower()]
-            # If the similar skill exists, this might be a duplicate
-            analysis['similarity_score'] = 0.7
-            analysis['closest_match'] = similar
-            analysis['reasoning'].append(f"Similar to existing skill: {similar}")
-    
-    # Determine if complementary
-    if analysis['similarity_score'] < 0.5:
-        analysis['is_complementary'] = True
-        analysis['reasoning'].append("Low similarity - likely complementary skill")
-    
-    return analysis
-
-def main():
-    base_dir = Path(__file__).parent.parent
-    
-    # Load remaining similar skills
-    remaining_file = base_dir / "remaining_similar_skills.json"
-    if not remaining_file.exists():
-        print("❌ remaining_similar_skills.json not found. Run the analysis first.")
-        return
-    
-    with open(remaining_file, 'r') as f:
-        data = json.load(f)
-    
-    # Load existing skills
-    catalog_file = base_dir / "data" / "catalog.json"
-    with open(catalog_file, 'r') as f:
-        catalog = json.load(f)
-    existing_skills = {s['name'].lower(): s for s in catalog.get('skills', [])}
-    
-    print(f"🔍 Analyzing {len(data['skills'])} remaining similar skills...\n")
-    
-    results = {
-        'truly_new': [],
-        'duplicates': [],
-        'complementary': [],
-        'needs_review': [],
-        'invalid_sources': []
-    }
-    
-    for skill in data['skills']:
-        skill_name = skill['name']
-        print(f"Analyzing: {skill_name}")
-        
-        # Skip if already exists
-        if skill['exists_in_catalog'] or skill['folder_exists']:
-            results['duplicates'].append({
-                'name': skill_name,
-                'reason': 'Already exists in repository',
-                'url': skill['url']
-            })
-            continue
-        
-        # Check source accessibility
-        exists, raw_url = check_skill_file_exists(skill['url'], skill.get('skill_part'))
-        if not exists:
-            results['invalid_sources'].append({
-                'name': skill_name,
-                'url': skill['url'],
-                'reason': 'SKILL.md not found or URL inaccessible'
-            })
-            continue
-        
-        # Analyze similarity
-        similarity_analysis = analyze_similarity(
-            skill_name,
-            skill['similar_to'],
-            existing_skills
-        )
-        
-        skill_result = {
-            'name': skill_name,
-            'url': skill['url'],
-            'raw_url': raw_url,
-            'description': skill['description'],
-            'org': skill['org'],
-            'category': skill['category'],
-            'similar_to': skill['similar_to'],
-            'similarity_analysis': similarity_analysis
-        }
-        
-        if similarity_analysis['is_duplicate']:
-            results['duplicates'].append(skill_result)
-        elif similarity_analysis['is_complementary']:
-            results['complementary'].append(skill_result)
-        else:
-            results['needs_review'].append(skill_result)
-    
-    # Generate report
-    report = {
-        'summary': {
-            'total_analyzed': len(data['skills']),
-            'truly_new': len(results['complementary']),
-            'duplicates': len(results['duplicates']),
-            'needs_review': len(results['needs_review']),
-            'invalid_sources': len(results['invalid_sources'])
-        },
-        'results': results
-    }
-    
-    output_file = base_dir / "similar_skills_analysis.json"
-    with open(output_file, 'w') as f:
-        json.dump(report, f, indent=2)
-    
-    print(f"\n✅ Analysis complete!")
-    print(f"📊 Summary:")
-    print(f"   - Truly new (complementary): {len(results['complementary'])}")
-    print(f"   - Duplicates: {len(results['duplicates'])}")
-    print(f"   - Needs review: {len(results['needs_review'])}")
-    print(f"   - Invalid sources: {len(results['invalid_sources'])}")
-    print(f"\n📄 Full report saved to: {output_file}")
-
-if __name__ == "__main__":
-    main()
--- a/scripts/count_uncommitted_skills.py
+++ b/scripts/count_uncommitted_skills.py
@@ -1,149 +0,0 @@
-#!/usr/bin/env python3
-"""
-Count uncommitted skills by checking git status.
-"""
-
-import subprocess
-import json
-from pathlib import Path
-
-def run_git_command(cmd):
-    """Run git command and return output."""
-    try:
-        result = subprocess.run(
-            cmd.split(),
-            capture_output=True,
-            text=True,
-            cwd=Path(__file__).parent.parent
-        )
-        return result.stdout.strip().split('\n') if result.stdout.strip() else []
-    except Exception as e:
-        print(f"Error running git command: {e}")
-        return []
-
-def main():
-    base_dir = Path(__file__).parent.parent
-    
-    # Get all uncommitted files
-    untracked = run_git_command("git ls-files --others --exclude-standard")
-    modified = run_git_command("git diff --name-only HEAD")
-    staged = run_git_command("git diff --cached --name-only")
-    
-    # Also check status
-    status_output = run_git_command("git status --porcelain")
-    
-    print("Git status output:")
-    for line in status_output[:20]:  # First 20 lines
-        print(f"  {line}")
-    print()
-    
-    # Filter for skill files
-    skill_files = []
-    for file_list in [untracked, modified, staged]:
-        for file in file_list:
-            if '/skills/' in file and file.endswith('SKILL.md'):
-                skill_name = file.split('/skills/')[1].split('/SKILL.md')[0]
-                if skill_name not in [s['name'] for s in skill_files]:
-                    skill_files.append({
-                        'name': skill_name,
-                        'file': file,
-                        'status': 'untracked' if file in untracked else ('staged' if file in staged else 'modified')
-                    })
-    
-    # Load catalog to verify
-    catalog_file = base_dir / "data" / "catalog.json"
-    with open(catalog_file, 'r') as f:
-        catalog = json.load(f)
-    
-    catalog_skills = {s['name']: s for s in catalog.get('skills', [])}
-    
-    print("=" * 70)
-    print("SKILLS NON COMMITTATE")
-    print("=" * 70)
-    print(f"\nTotale skills trovate: {len(skill_files)}")
-    print(f"Totale skills nel catalog: {catalog.get('total', 0)}")
-    print()
-    
-    # Group by status
-    untracked_skills = [s for s in skill_files if s['status'] == 'untracked']
-    modified_skills = [s for s in skill_files if s['status'] == 'modified']
-    staged_skills = [s for s in skill_files if s['status'] == 'staged']
-    
-    print(f"📝 Skills non tracciate (nuove): {len(untracked_skills)}")
-    print(f"📝 Skills modificate: {len(modified_skills)}")
-    print(f"📝 Skills staged: {len(staged_skills)}")
-    print()
-    
-    if untracked_skills:
-        print("Nuove skills (non tracciate):")
-        for skill in sorted(untracked_skills, key=lambda x: x['name']):
-            in_catalog = skill['name'] in catalog_skills
-            print(f"  ✅ {skill['name']} {'(in catalog)' if in_catalog else '(NOT in catalog)'}")
-    
-    if modified_skills:
-        print("\nSkills modificate:")
-        for skill in sorted(modified_skills, key=lambda x: x['name']):
-            print(f"  📝 {skill['name']}")
-    
-    if staged_skills:
-        print("\nSkills staged:")
-        for skill in sorted(staged_skills, key=lambda x: x['name']):
-            print(f"  📦 {skill['name']}")
-    
-    # Check for VoltAgent skills specifically
-    print("\n" + "=" * 70)
-    print("VERIFICA SKILLS DA VOLTAGENT")
-    print("=" * 70)
-    
-    voltagent_skills_phase1 = [
-        'commit', 'create-pr', 'find-bugs', 'iterate-pr',
-        'culture-index', 'fix-review', 'sharp-edges',
-        'expo-deployment', 'upgrading-expo',
-        'using-neon', 'vercel-deploy-claimable', 'design-md',
-        'hugging-face-cli', 'hugging-face-jobs',
-        'automate-whatsapp', 'observe-whatsapp', 'readme', 'screenshots',
-        'deep-research', 'imagen', 'swiftui-expert-skill',
-        'n8n-code-python', 'n8n-mcp-tools-expert', 'n8n-node-configuration'
-    ]
-    
-    voltagent_skills_phase2 = [
-        'frontend-slides', 'linear-claude-skill', 'skill-rails-upgrade',
-        'context-fundamentals', 'context-degradation', 'context-compression',
-        'context-optimization', 'multi-agent-patterns', 'tool-design',
-        'evaluation', 'memory-systems', 'terraform-skill'
-    ]
-    
-    all_voltagent = voltagent_skills_phase1 + voltagent_skills_phase2
-    
-    uncommitted_voltagent = []
-    for skill_name in all_voltagent:
-        skill_file = base_dir / "skills" / skill_name / "SKILL.md"
-        if skill_file.exists():
-            # Check if it's uncommitted
-            if skill_file.relative_to(base_dir).as_posix() in untracked:
-                uncommitted_voltagent.append(skill_name)
-            elif skill_file.relative_to(base_dir).as_posix() in modified:
-                uncommitted_voltagent.append(skill_name)
-            elif skill_file.relative_to(base_dir).as_posix() in staged:
-                uncommitted_voltagent.append(skill_name)
-    
-    print(f"\nSkills da VoltAgent non committate: {len(uncommitted_voltagent)}")
-    print(f"  Fase 1 (49 skills): {len([s for s in voltagent_skills_phase1 if s in uncommitted_voltagent])}")
-    print(f"  Fase 2 (12 skills): {len([s for s in voltagent_skills_phase2 if s in uncommitted_voltagent])}")
-    
-    print("\n" + "=" * 70)
-    print("RIEPILOGO FINALE")
-    print("=" * 70)
-    print(f"Totale skills non committate: {len(skill_files)}")
-    print(f"Skills da VoltAgent non committate: {len(uncommitted_voltagent)}")
-    print(f"Altre skills non committate: {len(skill_files) - len(uncommitted_voltagent)}")
-    
-    return {
-        'total_uncommitted': len(skill_files),
-        'voltagent_uncommitted': len(uncommitted_voltagent),
-        'voltagent_phase1': len([s for s in voltagent_skills_phase1 if s in uncommitted_voltagent]),
-        'voltagent_phase2': len([s for s in voltagent_skills_phase2 if s in uncommitted_voltagent])
-    }
-
-if __name__ == "__main__":
-    main()
--- a/scripts/implement_similar_skills.py
+++ b/scripts/implement_similar_skills.py
@@ -1,271 +0,0 @@
-#!/usr/bin/env python3
-"""
-Implement the 12 new skills from similar skills analysis.
-9 recommended + 3 verified (evaluation, memory-systems, terraform-skill)
-"""
-
-import json
-import re
-import sys
-from pathlib import Path
-from urllib.request import urlopen, Request
-from urllib.error import URLError, HTTPError
-from typing import Dict, Optional
-
-def normalize_skill_name(name: str) -> str:
-    """Normalize skill name to kebab-case."""
-    name = re.sub(r'[^a-z0-9-]', '-', name.lower())
-    name = re.sub(r'-+', '-', name)
-    return name.strip('-')
-
-def download_file(url: str) -> Optional[str]:
-    """Download content from URL."""
-    try:
-        req = Request(url)
-        req.add_header('User-Agent', 'Mozilla/5.0 (compatible; AntigravitySkillsDownloader/1.0)')
-        with urlopen(req, timeout=15) as response:
-            return response.read().decode('utf-8')
-    except Exception as e:
-        print(f"    ❌ Error downloading {url}: {e}")
-        return None
-
-def parse_frontmatter(content: str) -> Optional[Dict]:
-    """Parse YAML frontmatter."""
-    fm_match = re.search(r'^---\s*\n(.*?)\n---', content, re.DOTALL)
-    if not fm_match:
-        return None
-    
-    fm_text = fm_match.group(1)
-    metadata = {}
-    for line in fm_text.split('\n'):
-        if ':' in line:
-            key, val = line.split(':', 1)
-            metadata[key.strip()] = val.strip().strip('"').strip("'")
-    return metadata
-
-def ensure_frontmatter_compliance(content: str, skill_name: str, source_url: str, description: str) -> str:
-    """Ensure SKILL.md has compliant frontmatter."""
-    metadata = parse_frontmatter(content)
-    
-    if not metadata:
-        # No frontmatter, add it
-        frontmatter = f"""---
-name: {skill_name}
-description: {description}
-source: {source_url}
-risk: safe
---
-
-"""
-        return frontmatter + content
-    
-    # Update existing frontmatter
-    metadata['name'] = skill_name
-    metadata['description'] = description
-    metadata['source'] = source_url
-    if 'risk' not in metadata:
-        metadata['risk'] = 'safe'
-    
-    # Rebuild frontmatter
-    frontmatter_lines = ['---']
-    for key, value in metadata.items():
-        if isinstance(value, str) and (' ' in value or ':' in value):
-            frontmatter_lines.append(f'{key}: "{value}"')
-        else:
-            frontmatter_lines.append(f'{key}: {value}')
-    frontmatter_lines.append('---\n')
-    
-    # Replace frontmatter in content
-    content_without_fm = re.sub(r'^---\s*\n.*?\n---\s*\n', '', content, flags=re.DOTALL)
-    return '\n'.join(frontmatter_lines) + content_without_fm
-
-def ensure_when_to_use_section(content: str, description: str) -> str:
-    """Ensure 'When to Use' section exists."""
-    if re.search(r'##\s+When\s+to\s+Use', content, re.IGNORECASE):
-        return content
-    
-    # Add section after frontmatter
-    when_to_use = f"""
-## When to Use This Skill
-
-{description}
-
-Use this skill when working with {description.lower()}.
-"""
-    
-    # Insert after frontmatter
-    content = re.sub(r'(---\s*\n.*?\n---\s*\n)', r'\1' + when_to_use, content, flags=re.DOTALL)
-    return content
-
-def main():
-    base_dir = Path(__file__).parent.parent
-    
-    # Load similar skills analysis
-    analysis_file = base_dir / "similar_skills_analysis.json"
-    with open(analysis_file, 'r') as f:
-        analysis = json.load(f)
-    
-    # Skills to implement: 9 recommended + 3 verified
-    skills_to_implement = [
-        # 9 Recommended
-        {
-            'name': 'frontend-slides',
-            'url': 'https://github.com/zarazhangrui/frontend-slides',
-            'raw_url': 'https://github.com/zarazhangrui/frontend-slides/raw/main/SKILL.md',
-            'description': 'Generate animation-rich HTML presentations with visual style previews',
-            'org': 'zarazhangrui',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'linear-claude-skill',
-            'url': 'https://github.com/wrsmith108/linear-claude-skill',
-            'raw_url': 'https://github.com/wrsmith108/linear-claude-skill/raw/main/SKILL.md',
-            'description': 'Manage Linear issues, projects, and teams',
-            'org': 'wrsmith108',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'skill-rails-upgrade',
-            'url': 'https://github.com/robzolkos/skill-rails-upgrade',
-            'raw_url': 'https://github.com/robzolkos/skill-rails-upgrade/raw/master/SKILL.md',
-            'description': 'Analyze Rails apps and provide upgrade assessments',
-            'org': 'robzolkos',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'context-fundamentals',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-fundamentals',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-fundamentals/SKILL.md',
-            'description': 'Understand what context is, why it matters, and the anatomy of context in agent systems',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'context-degradation',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-degradation',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-degradation/SKILL.md',
-            'description': 'Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'context-compression',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-compression',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-compression/SKILL.md',
-            'description': 'Design and evaluate compression strategies for long-running sessions',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'context-optimization',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-optimization',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-optimization/SKILL.md',
-            'description': 'Apply compaction, masking, and caching strategies',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'multi-agent-patterns',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/multi-agent-patterns',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/multi-agent-patterns/SKILL.md',
-            'description': 'Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'tool-design',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/tool-design/SKILL.md',
-            'description': 'Build tools that agents can use effectively, including architectural reduction patterns',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        # 3 Verified (notebooklm-skill is duplicate, skip it)
-        {
-            'name': 'evaluation',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/evaluation',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/evaluation/SKILL.md',
-            'description': 'Build evaluation frameworks for agent systems',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'memory-systems',
-            'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/memory-systems',
-            'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/memory-systems/SKILL.md',
-            'description': 'Design short-term, long-term, and graph-based memory architectures',
-            'org': 'muratcankoylan',
-            'category': 'Community Skills'
-        },
-        {
-            'name': 'terraform-skill',
-            'url': 'https://github.com/antonbabenko/terraform-skill',
-            'raw_url': 'https://github.com/antonbabenko/terraform-skill/raw/master/SKILL.md',
-            'description': 'Terraform infrastructure as code best practices',
-            'org': 'antonbabenko',
-            'category': 'Community Skills'
-        },
-    ]
-    
-    print(f"🚀 Implementing {len(skills_to_implement)} new skills...\n")
-    
-    results = {
-        'success': [],
-        'failed': []
-    }
-    
-    for skill in skills_to_implement:
-        skill_name = skill['name']
-        raw_url = skill['raw_url']
-        source_url = skill['url']
-        description = skill['description']
-        
-        print(f"📦 Processing: {skill_name}")
-        
-        # Download SKILL.md
-        content = download_file(raw_url)
-        if not content:
-            print(f"    ❌ Failed to download")
-            results['failed'].append(skill_name)
-            continue
-        
-        # Check if it's HTML (shouldn't be, but just in case)
-        if '<!DOCTYPE html>' in content or ('<html>' in content.lower() and content.count('<html>') > 1):
-            print(f"    ⚠️  Received HTML instead of markdown, trying alternative URL")
-            # Try alternative raw URL
-            alt_url = raw_url.replace('/raw/main/', '/raw/master/') if '/raw/main/' in raw_url else raw_url.replace('/raw/master/', '/raw/main/')
-            alt_content = download_file(alt_url)
-            if alt_content and not ('<!DOCTYPE html>' in alt_content or '<html>' in alt_content.lower()):
-                content = alt_content
-                print(f"    ✅ Got markdown from alternative URL")
-            else:
-                print(f"    ❌ Still HTML, skipping")
-                results['failed'].append(skill_name)
-                continue
-        
-        # Ensure compliance
-        content = ensure_frontmatter_compliance(content, skill_name, source_url, description)
-        content = ensure_when_to_use_section(content, description)
-        
-        # Create skill directory
-        skill_dir = base_dir / "skills" / skill_name
-        skill_dir.mkdir(parents=True, exist_ok=True)
-        
-        # Write SKILL.md
-        skill_file = skill_dir / "SKILL.md"
-        skill_file.write_text(content, encoding='utf-8')
-        
-        print(f"    ✅ Created: {skill_file}")
-        results['success'].append(skill_name)
-    
-    print(f"\n✅ Implementation complete!")
-    print(f"   Success: {len(results['success'])}")
-    print(f"   Failed: {len(results['failed'])}")
-    
-    if results['failed']:
-        print(f"\n❌ Failed skills: {', '.join(results['failed'])}")
-    
-    return results
-
-if __name__ == "__main__":
-    main()
--- a/similar_skills_analysis.json
+++ b/similar_skills_analysis.json
@@ -1,703 +0,0 @@
-{
-  "summary": {
-    "total_analyzed": 89,
-    "truly_new": 0,
-    "duplicates": 2,
-    "needs_review": 13,
-    "invalid_sources": 74
-  },
-  "results": {
-    "truly_new": [],
-    "duplicates": [
-      {
-        "name": "react-best-practices",
-        "reason": "Already exists in repository",
-        "url": "https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices"
-      },
-      {
-        "name": "postgres-best-practices",
-        "reason": "Already exists in repository",
-        "url": "https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices"
-      }
-    ],
-    "complementary": [],
-    "needs_review": [
-      {
-        "name": "frontend-slides",
-        "url": "https://github.com/zarazhangrui/frontend-slides",
-        "raw_url": "https://github.com/zarazhangrui/frontend-slides/raw/main/SKILL.md",
-        "description": "Generate animation-rich HTML presentations with visual style previews",
-        "org": "zarazhangrui",
-        "category": "Community Skills",
-        "similar_to": [
-          "frontend-patterns",
-          "frontend-design"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "frontend-design",
-          "reasoning": [
-            "Similar to existing skill: frontend-patterns",
-            "Similar to existing skill: frontend-design"
-          ]
-        }
-      },
-      {
-        "name": "notebooklm-skill",
-        "url": "https://github.com/PleasePrompto/notebooklm-skill",
-        "raw_url": "https://github.com/PleasePrompto/notebooklm-skill/raw/master/SKILL.md",
-        "description": "Interact with NotebookLM for document-based conversations",
-        "org": "PleasePrompto",
-        "category": "Community Skills",
-        "similar_to": [
-          "notebooklm",
-          "slo-implementation"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "slo-implementation",
-          "reasoning": [
-            "Similar to existing skill: notebooklm",
-            "Similar to existing skill: slo-implementation"
-          ]
-        }
-      },
-      {
-        "name": "linear-claude-skill",
-        "url": "https://github.com/wrsmith108/linear-claude-skill",
-        "raw_url": "https://github.com/wrsmith108/linear-claude-skill/raw/main/SKILL.md",
-        "description": "Manage Linear issues, projects, and teams",
-        "org": "wrsmith108",
-        "category": "Community Skills",
-        "similar_to": [
-          "api-design-principles",
-          "seo-content-auditor"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "seo-content-auditor",
-          "reasoning": [
-            "Similar to existing skill: api-design-principles",
-            "Similar to existing skill: seo-content-auditor"
-          ]
-        }
-      },
-      {
-        "name": "skill-rails-upgrade",
-        "url": "https://github.com/robzolkos/skill-rails-upgrade",
-        "raw_url": "https://github.com/robzolkos/skill-rails-upgrade/raw/master/SKILL.md",
-        "description": "Analyze Rails apps and provide upgrade assessments",
-        "org": "robzolkos",
-        "category": "Community Skills",
-        "similar_to": [
-          "api-design-principles"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "api-design-principles",
-          "reasoning": [
-            "Similar to existing skill: api-design-principles"
-          ]
-        }
-      },
-      {
-        "name": "terraform-skill",
-        "url": "https://github.com/antonbabenko/terraform-skill",
-        "raw_url": "https://github.com/antonbabenko/terraform-skill/raw/master/SKILL.md",
-        "description": "Terraform infrastructure as code best practices",
-        "org": "antonbabenko",
-        "category": "Community Skills",
-        "similar_to": [
-          "internal-comms",
-          "skill-creator",
-          "slack-gif-creator"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "slack-gif-creator",
-          "reasoning": [
-            "Similar to existing skill: internal-comms",
-            "Similar to existing skill: skill-creator",
-            "Similar to existing skill: slack-gif-creator"
-          ]
-        }
-      },
-      {
-        "name": "context-fundamentals",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-fundamentals",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Understand what context is, why it matters, and the anatomy of context in agent systems",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "salesforce-development"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "salesforce-development",
-          "reasoning": [
-            "Similar to existing skill: salesforce-development"
-          ]
-        }
-      },
-      {
-        "name": "context-degradation",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-degradation",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "design-orchestration",
-          "production-code-audit",
-          "react-modernization",
-          "saga-orchestration",
-          "screen-reader-testing",
-          "seo-content-auditor",
-          "vector-index-tuning"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "vector-index-tuning",
-          "reasoning": [
-            "Similar to existing skill: design-orchestration",
-            "Similar to existing skill: production-code-audit",
-            "Similar to existing skill: react-modernization",
-            "Similar to existing skill: saga-orchestration",
-            "Similar to existing skill: screen-reader-testing",
-            "Similar to existing skill: seo-content-auditor",
-            "Similar to existing skill: vector-index-tuning"
-          ]
-        }
-      },
-      {
-        "name": "context-compression",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-compression",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Design and evaluate compression strategies for long-running sessions",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "incident-responder",
-          "monorepo-architect",
-          "postmortem-writing",
-          "projection-patterns",
-          "scroll-experience",
-          "service-mesh-expert"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "service-mesh-expert",
-          "reasoning": [
-            "Similar to existing skill: incident-responder",
-            "Similar to existing skill: monorepo-architect",
-            "Similar to existing skill: postmortem-writing",
-            "Similar to existing skill: projection-patterns",
-            "Similar to existing skill: scroll-experience",
-            "Similar to existing skill: service-mesh-expert"
-          ]
-        }
-      },
-      {
-        "name": "context-optimization",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-optimization",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Apply compaction, masking, and caching strategies",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "app-store-optimization",
-          "monorepo-architect",
-          "react-modernization"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "react-modernization",
-          "reasoning": [
-            "Similar to existing skill: app-store-optimization",
-            "Similar to existing skill: monorepo-architect",
-            "Similar to existing skill: react-modernization"
-          ]
-        }
-      },
-      {
-        "name": "multi-agent-patterns",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/multi-agent-patterns",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "agent-manager-skill",
-          "computer-use-agents",
-          "gitlab-ci-patterns",
-          "rag-implementation"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "rag-implementation",
-          "reasoning": [
-            "Similar to existing skill: agent-manager-skill",
-            "Similar to existing skill: computer-use-agents",
-            "Similar to existing skill: gitlab-ci-patterns",
-            "Similar to existing skill: rag-implementation"
-          ]
-        }
-      },
-      {
-        "name": "memory-systems",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/memory-systems",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Design short-term, long-term, and graph-based memory architectures",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "agent-memory-systems"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "agent-memory-systems",
-          "reasoning": [
-            "Similar to existing skill: agent-memory-systems"
-          ]
-        }
-      },
-      {
-        "name": "tool-design",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Build tools that agents can use effectively, including architectural reduction patterns",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "mobile-design"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "mobile-design",
-          "reasoning": [
-            "Similar to existing skill: mobile-design"
-          ]
-        }
-      },
-      {
-        "name": "evaluation",
-        "url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/evaluation",
-        "raw_url": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/SKILL.md",
-        "description": "Build evaluation frameworks for agent systems",
-        "org": "muratcankoylan",
-        "category": "Community Skills",
-        "similar_to": [
-          "agent-evaluation",
-          "llm-evaluation"
-        ],
-        "similarity_analysis": {
-          "is_duplicate": false,
-          "is_complementary": false,
-          "similarity_score": 0.7,
-          "closest_match": "llm-evaluation",
-          "reasoning": [
-            "Similar to existing skill: agent-evaluation",
-            "Similar to existing skill: llm-evaluation"
-          ]
-        }
-      }
-    ],
-    "invalid_sources": [
-      {
-        "name": "template",
-        "url": "https://github.com/anthropics/skills/tree/main/template",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "react-native-skills",
-        "url": "https://github.com/vercel-labs/agent-skills/tree/main/skills/react-native-skills",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "building-ai-agent-on-cloudflare",
-        "url": "https://github.com/cloudflare/skills/tree/main/building-ai-agent-on-cloudflare",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "building-mcp-server-on-cloudflare",
-        "url": "https://github.com/cloudflare/skills/tree/main/building-mcp-server-on-cloudflare",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "commands",
-        "url": "https://github.com/cloudflare/skills/tree/main/commands",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "durable-objects",
-        "url": "https://github.com/cloudflare/skills/tree/main/durable-objects",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "web-perf",
-        "url": "https://github.com/cloudflare/skills/tree/main/web-perf",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "react-components",
-        "url": "https://github.com/google-labs-code/stitch-skills/tree/main/skills/react-components",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-datasets",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-datasets",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-evaluation",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-evaluation",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-model-trainer",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-model-trainer",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-paper-publisher",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-paper-publisher",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-tool-builder",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-tool-builder",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "hugging-face-trackio",
-        "url": "https://github.com/huggingface/skills/tree/main/skills/hugging-face-trackio",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "stripe-best-practices",
-        "url": "https://github.com/stripe/ai/tree/main/skills/stripe-best-practices",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "upgrade-stripe",
-        "url": "https://github.com/stripe/ai/tree/main/skills/upgrade-stripe",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "ask-questions-if-underspecified",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/ask-questions-if-underspecified",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "audit-context-building",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/audit-context-building",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "building-secure-contracts",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/building-secure-contracts",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "burpsuite-project-parser",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/burpsuite-project-parser",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "claude-in-chrome-troubleshooting",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/claude-in-chrome-troubleshooting",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "constant-time-analysis",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/constant-time-analysis",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "differential-review",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/differential-review",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "dwarf-expert",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/dwarf-expert",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "entry-point-analyzer",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/entry-point-analyzer",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "firebase-apk-scanner",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/firebase-apk-scanner",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "insecure-defaults",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/insecure-defaults",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "modern-python",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/modern-python",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "property-based-testing",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/property-based-testing",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "semgrep-rule-creator",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/semgrep-rule-creator",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "semgrep-rule-variant-creator",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/semgrep-rule-variant-creator",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "spec-to-code-compliance",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/spec-to-code-compliance",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "static-analysis",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/static-analysis",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "testing-handbook-skills",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/testing-handbook-skills",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "variant-analysis",
-        "url": "https://github.com/trailofbits/skills/tree/main/plugins/variant-analysis",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "expo-app-design",
-        "url": "https://github.com/expo/skills/tree/main/plugins/expo-app-design",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "agents-md",
-        "url": "https://github.com/getsentry/skills/tree/main/plugins/sentry-skills/skills/agents-md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "claude-settings-audit",
-        "url": "https://github.com/getsentry/skills/tree/main/plugins/sentry-skills/skills/claude-settings-audit",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "code-review",
-        "url": "https://github.com/getsentry/skills/tree/main/plugins/sentry-skills/skills/code-review",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "best-practices",
-        "url": "https://github.com/better-auth/skills/tree/main/better-auth/best-practices",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "commands",
-        "url": "https://github.com/better-auth/skills/tree/main/better-auth/commands",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "create-auth",
-        "url": "https://github.com/better-auth/skills/tree/main/better-auth/create-auth",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "tinybird-best-practices",
-        "url": "https://github.com/tinybirdco/tinybird-agent-skills/tree/main/skills/tinybird-best-practices",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "cloudflare-skill",
-        "url": "https://github.com/dmmulroy/cloudflare-skill/tree/main/skill/cloudflare",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "remotion",
-        "url": "https://github.com/remotion-dev/skills/tree/main/skills/remotion",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "marketingskills",
-        "url": "https://github.com/coreyhaines31/marketingskills",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "content-research-writer",
-        "url": "https://github.com/ComposioHQ/awesome-claude-skills/tree/master/content-research-writer",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "competitive-ads-extractor",
-        "url": "https://github.com/ComposioHQ/awesome-claude-skills/tree/master/competitive-ads-extractor",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "notion-skills-for-claude",
-        "url": "https://www.notion.so/notiondevs/Notion-Skills-for-Claude-28da4445d27180c7af1df7d8615723d0",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "integrate-whatsapp",
-        "url": "https://github.com/gokapso/agent-skills/tree/master/skills/integrate-whatsapp",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "sharing-skills",
-        "url": "https://github.com/obra/superpowers/blob/main/skills/sharing-skills/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "meeting-insights-analyzer",
-        "url": "https://github.com/ComposioHQ/awesome-claude-skills/tree/master/meeting-insights-analyzer",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "image-enhancer",
-        "url": "https://github.com/ComposioHQ/awesome-claude-skills/tree/master/image-enhancer",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "rootly-incident-responder",
-        "url": "https://github.com/Rootly-AI-Labs/Rootly-MCP-server/blob/main/examples/skills/rootly-incident-responder.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "ios-simulator-skill",
-        "url": "https://github.com/conorluddy/ios-simulator-skill",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "postgres",
-        "url": "https://github.com/sanjay3290/ai-skills/tree/main/skills/postgres",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "ui-ux-pro-max-skill",
-        "url": "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "changelog-generator",
-        "url": "https://github.com/ComposioHQ/awesome-claude-skills/tree/master/changelog-generator",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "root-cause-tracing",
-        "url": "https://github.com/obra/superpowers/blob/main/skills/root-cause-tracing/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "testing-skills-with-subagents",
-        "url": "https://github.com/obra/superpowers/blob/main/skills/testing-skills-with-subagents/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "testing-anti-patterns",
-        "url": "https://github.com/obra/superpowers/blob/main/skills/testing-anti-patterns/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "condition-based-waiting",
-        "url": "https://github.com/obra/superpowers/blob/main/skills/condition-based-waiting/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "commands",
-        "url": "https://github.com/obra/superpowers/tree/main/skills/commands",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "dev-agent-skills",
-        "url": "https://github.com/fvadicamo/dev-agent-skills",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "claude-bootstrap",
-        "url": "https://github.com/alinaqi/claude-bootstrap",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "recursive-decomposition-skill",
-        "url": "https://github.com/massimodeluisa/recursive-decomposition-skill",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "react-native-best-practices",
-        "url": "https://github.com/callstackincubator/agent-skills/blob/main/skills/react-native-best-practices/SKILL.md",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "swift-patterns-skill",
-        "url": "https://github.com/efremidze/swift-patterns-skill/tree/main/swift-patterns",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "ai-research-skills",
-        "url": "https://github.com/zechenzhangAGI/AI-research-SKILLs",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "n8n-code-javascript",
-        "url": "https://github.com/czlonkowski/n8n-skills/tree/main/skills/n8n-code-javascript",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "n8n-expression-syntax",
-        "url": "https://github.com/czlonkowski/n8n-skills/tree/main/skills/n8n-expression-syntax",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "n8n-validation-expert",
-        "url": "https://github.com/czlonkowski/n8n-skills/tree/main/skills/n8n-validation-expert",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "n8n-workflow-patterns",
-        "url": "https://github.com/czlonkowski/n8n-skills/tree/main/skills/n8n-workflow-patterns",
-        "reason": "SKILL.md not found or URL inaccessible"
-      },
-      {
-        "name": "materials-simulation-skills",
-        "url": "https://github.com/HeshamFS/materials-simulation-skills",
-        "reason": "SKILL.md not found or URL inaccessible"
-      }
-    ]
-  }
-}
--- a/skills/fp-ts-errors/SKILL.md
+++ b/skills/fp-ts-errors/SKILL.md
@@ -0,0 +1,856 @@
+---
+name: fp-ts-errors
+description: Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.
+risk: safe
+source: https://github.com/whatiskadudoing/fp-ts-skills
+---
+
+# Practical Error Handling with fp-ts
+
+This skill teaches you how to handle errors without try/catch spaghetti. No academic jargon - just practical patterns for real problems.
+
+## When to Use This Skill
+
+- When you want type-safe error handling in TypeScript
+- When replacing try/catch with Either and TaskEither patterns
+- When building APIs or services that need explicit error types
+- When accumulating multiple validation errors
+
+The core idea: **Errors are just data**. Instead of throwing them into the void and hoping someone catches them, return them as values that TypeScript can track.
+
+---
+
+## 1. Stop Throwing Everywhere
+
+### The Problem with Exceptions
+
+Exceptions are invisible in your types. They break the contract between functions.
+
+```typescript
+// What this function signature promises:
+function getUser(id: string): User
+
+// What it actually does:
+function getUser(id: string): User {
+  if (!id) throw new Error('ID required')
+  const user = db.find(id)
+  if (!user) throw new Error('User not found')
+  return user
+}
+
+// The caller has no idea this can fail
+const user = getUser(id) // Might explode!
+```
+
+You end up with code like this:
+
+```typescript
+// MESSY: try/catch everywhere
+function processOrder(orderId: string) {
+  let order
+  try {
+    order = getOrder(orderId)
+  } catch (e) {
+    console.error('Failed to get order')
+    return null
+  }
+
+  let user
+  try {
+    user = getUser(order.userId)
+  } catch (e) {
+    console.error('Failed to get user')
+    return null
+  }
+
+  let payment
+  try {
+    payment = chargeCard(user.cardId, order.total)
+  } catch (e) {
+    console.error('Payment failed')
+    return null
+  }
+
+  return { order, user, payment }
+}
+```
+
+### The Solution: Return Errors as Values
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+// Now TypeScript KNOWS this can fail
+function getUser(id: string): E.Either<string, User> {
+  if (!id) return E.left('ID required')
+  const user = db.find(id)
+  if (!user) return E.left('User not found')
+  return E.right(user)
+}
+
+// The caller is forced to handle both cases
+const result = getUser(id)
+// result is Either<string, User> - error OR success, never both
+```
+
+---
+
+## 2. The Result Pattern (Either)
+
+`Either<E, A>` is simple: it holds either an error (`E`) or a value (`A`).
+
+- `Left` = error case
+- `Right` = success case (think "right" as in "correct")
+
+```typescript
+import * as E from 'fp-ts/Either'
+
+// Creating values
+const success = E.right(42)           // Right(42)
+const failure = E.left('Oops')        // Left('Oops')
+
+// Checking what you have
+if (E.isRight(result)) {
+  console.log(result.right) // The success value
+} else {
+  console.log(result.left)  // The error
+}
+
+// Better: pattern match with fold
+const message = pipe(
+  result,
+  E.fold(
+    (error) => `Failed: ${error}`,
+    (value) => `Got: ${value}`
+  )
+)
+```
+
+### Converting Throwing Code to Either
+
+```typescript
+// Wrap any throwing function with tryCatch
+const parseJSON = (json: string): E.Either<Error, unknown> =>
+  E.tryCatch(
+    () => JSON.parse(json),
+    (e) => (e instanceof Error ? e : new Error(String(e)))
+  )
+
+parseJSON('{"valid": true}')  // Right({ valid: true })
+parseJSON('not json')          // Left(SyntaxError: ...)
+
+// For functions you'll reuse, use tryCatchK
+const safeParseJSON = E.tryCatchK(
+  JSON.parse,
+  (e) => (e instanceof Error ? e : new Error(String(e)))
+)
+```
+
+### Common Either Operations
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+// Transform the success value
+const doubled = pipe(
+  E.right(21),
+  E.map(n => n * 2)
+) // Right(42)
+
+// Transform the error
+const betterError = pipe(
+  E.left('bad'),
+  E.mapLeft(e => `Error: ${e}`)
+) // Left('Error: bad')
+
+// Provide a default for errors
+const value = pipe(
+  E.left('failed'),
+  E.getOrElse(() => 0)
+) // 0
+
+// Convert nullable to Either
+const fromNullable = E.fromNullable('not found')
+fromNullable(user)  // Right(user) if exists, Left('not found') if null/undefined
+```
+
+---
+
+## 3. Chaining Operations That Might Fail
+
+The real power comes from chaining. Each step can fail, but you write it as a clean pipeline.
+
+### Before: Nested Try/Catch Hell
+
+```typescript
+// MESSY: Each step can fail, nested try/catch everywhere
+function processUserOrder(userId: string, productId: string): Result | null {
+  let user
+  try {
+    user = getUser(userId)
+  } catch (e) {
+    logError('User fetch failed', e)
+    return null
+  }
+
+  if (!user.isActive) {
+    logError('User not active')
+    return null
+  }
+
+  let product
+  try {
+    product = getProduct(productId)
+  } catch (e) {
+    logError('Product fetch failed', e)
+    return null
+  }
+
+  if (product.stock < 1) {
+    logError('Out of stock')
+    return null
+  }
+
+  let order
+  try {
+    order = createOrder(user, product)
+  } catch (e) {
+    logError('Order creation failed', e)
+    return null
+  }
+
+  return order
+}
+```
+
+### After: Clean Chain with Either
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+// Each function returns Either<Error, T>
+const getUser = (id: string): E.Either<string, User> => { ... }
+const getProduct = (id: string): E.Either<string, Product> => { ... }
+const createOrder = (user: User, product: Product): E.Either<string, Order> => { ... }
+
+// Chain them together - first error stops the chain
+const processUserOrder = (userId: string, productId: string): E.Either<string, Order> =>
+  pipe(
+    getUser(userId),
+    E.filterOrElse(
+      user => user.isActive,
+      () => 'User not active'
+    ),
+    E.chain(user =>
+      pipe(
+        getProduct(productId),
+        E.filterOrElse(
+          product => product.stock >= 1,
+          () => 'Out of stock'
+        ),
+        E.chain(product => createOrder(user, product))
+      )
+    )
+  )
+
+// Or use Do notation for cleaner access to intermediate values
+const processUserOrder = (userId: string, productId: string): E.Either<string, Order> =>
+  pipe(
+    E.Do,
+    E.bind('user', () => getUser(userId)),
+    E.filterOrElse(
+      ({ user }) => user.isActive,
+      () => 'User not active'
+    ),
+    E.bind('product', () => getProduct(productId)),
+    E.filterOrElse(
+      ({ product }) => product.stock >= 1,
+      () => 'Out of stock'
+    ),
+    E.chain(({ user, product }) => createOrder(user, product))
+  )
+```
+
+### Different Error Types? Use chainW
+
+```typescript
+type ValidationError = { type: 'validation'; message: string }
+type DbError = { type: 'db'; message: string }
+
+const validateInput = (id: string): E.Either<ValidationError, string> => { ... }
+const fetchFromDb = (id: string): E.Either<DbError, User> => { ... }
+
+// chainW (W = "wider") automatically unions the error types
+const process = (id: string): E.Either<ValidationError | DbError, User> =>
+  pipe(
+    validateInput(id),
+    E.chainW(validId => fetchFromDb(validId))
+  )
+```
+
+---
+
+## 4. Collecting Multiple Errors
+
+Sometimes you want ALL errors, not just the first one. Form validation is the classic example.
+
+### Before: Collecting Errors Manually
+
+```typescript
+// MESSY: Manual error accumulation
+function validateForm(form: FormData): { valid: boolean; errors: string[] } {
+  const errors: string[] = []
+
+  if (!form.email) {
+    errors.push('Email required')
+  } else if (!form.email.includes('@')) {
+    errors.push('Invalid email')
+  }
+
+  if (!form.password) {
+    errors.push('Password required')
+  } else if (form.password.length < 8) {
+    errors.push('Password too short')
+  }
+
+  if (!form.age) {
+    errors.push('Age required')
+  } else if (form.age < 18) {
+    errors.push('Must be 18+')
+  }
+
+  return { valid: errors.length === 0, errors }
+}
+```
+
+### After: Validation with Error Accumulation
+
+```typescript
+import * as E from 'fp-ts/Either'
+import * as NEA from 'fp-ts/NonEmptyArray'
+import { sequenceS } from 'fp-ts/Apply'
+import { pipe } from 'fp-ts/function'
+
+// Errors as a NonEmptyArray (always at least one)
+type Errors = NEA.NonEmptyArray<string>
+
+// Create the applicative that accumulates errors
+const validation = E.getApplicativeValidation(NEA.getSemigroup<string>())
+
+// Validators that return Either<Errors, T>
+const validateEmail = (email: string): E.Either<Errors, string> =>
+  !email ? E.left(NEA.of('Email required'))
+  : !email.includes('@') ? E.left(NEA.of('Invalid email'))
+  : E.right(email)
+
+const validatePassword = (password: string): E.Either<Errors, string> =>
+  !password ? E.left(NEA.of('Password required'))
+  : password.length < 8 ? E.left(NEA.of('Password too short'))
+  : E.right(password)
+
+const validateAge = (age: number | undefined): E.Either<Errors, number> =>
+  age === undefined ? E.left(NEA.of('Age required'))
+  : age < 18 ? E.left(NEA.of('Must be 18+'))
+  : E.right(age)
+
+// Combine all validations - collects ALL errors
+const validateForm = (form: FormData) =>
+  sequenceS(validation)({
+    email: validateEmail(form.email),
+    password: validatePassword(form.password),
+    age: validateAge(form.age)
+  })
+
+// Usage
+validateForm({ email: '', password: '123', age: 15 })
+// Left(['Email required', 'Password too short', 'Must be 18+'])
+
+validateForm({ email: 'a@b.com', password: 'longpassword', age: 25 })
+// Right({ email: 'a@b.com', password: 'longpassword', age: 25 })
+```
+
+### Field-Level Errors for Forms
+
+```typescript
+interface FieldError {
+  field: string
+  message: string
+}
+
+type FormErrors = NEA.NonEmptyArray<FieldError>
+
+const fieldError = (field: string, message: string): FormErrors =>
+  NEA.of({ field, message })
+
+const formValidation = E.getApplicativeValidation(NEA.getSemigroup<FieldError>())
+
+// Now errors know which field they belong to
+const validateEmail = (email: string): E.Either<FormErrors, string> =>
+  !email ? E.left(fieldError('email', 'Required'))
+  : !email.includes('@') ? E.left(fieldError('email', 'Invalid format'))
+  : E.right(email)
+
+// Easy to display in UI
+const getFieldError = (errors: FormErrors, field: string): string | undefined =>
+  errors.find(e => e.field === field)?.message
+```
+
+---
+
+## 5. Async Operations (TaskEither)
+
+For async operations that can fail, use `TaskEither`. It's like `Either` but for promises.
+
+- `TaskEither<E, A>` = a function that returns `Promise<Either<E, A>>`
+- Lazy: nothing runs until you execute it
+
+```typescript
+import * as TE from 'fp-ts/TaskEither'
+import { pipe } from 'fp-ts/function'
+
+// Wrap any async operation
+const fetchUser = (id: string): TE.TaskEither<Error, User> =>
+  TE.tryCatch(
+    () => fetch(`/api/users/${id}`).then(r => r.json()),
+    (e) => (e instanceof Error ? e : new Error(String(e)))
+  )
+
+// Chain async operations - just like Either
+const getUserPosts = (userId: string): TE.TaskEither<Error, Post[]> =>
+  pipe(
+    fetchUser(userId),
+    TE.chain(user => fetchPosts(user.id))
+  )
+
+// Execute when ready
+const result = await getUserPosts('123')() // Returns Either<Error, Post[]>
+```
+
+### Before: Promise Chain with Error Handling
+
+```typescript
+// MESSY: try/catch mixed with promise chains
+async function loadDashboard(userId: string) {
+  try {
+    const user = await fetchUser(userId)
+    if (!user) throw new Error('User not found')
+
+    let posts, notifications, settings
+    try {
+      [posts, notifications, settings] = await Promise.all([
+        fetchPosts(user.id),
+        fetchNotifications(user.id),
+        fetchSettings(user.id)
+      ])
+    } catch (e) {
+      // Which one failed? Who knows!
+      console.error('Failed to load data', e)
+      return null
+    }
+
+    return { user, posts, notifications, settings }
+  } catch (e) {
+    console.error('Failed to load user', e)
+    return null
+  }
+}
+```
+
+### After: Clean TaskEither Pipeline
+
+```typescript
+import * as TE from 'fp-ts/TaskEither'
+import { sequenceS } from 'fp-ts/Apply'
+import { pipe } from 'fp-ts/function'
+
+const loadDashboard = (userId: string) =>
+  pipe(
+    fetchUser(userId),
+    TE.chain(user =>
+      pipe(
+        // Parallel fetch with sequenceS
+        sequenceS(TE.ApplyPar)({
+          posts: fetchPosts(user.id),
+          notifications: fetchNotifications(user.id),
+          settings: fetchSettings(user.id)
+        }),
+        TE.map(data => ({ user, ...data }))
+      )
+    )
+  )
+
+// Execute and handle both cases
+pipe(
+  loadDashboard('123'),
+  TE.fold(
+    (error) => T.of(renderError(error)),
+    (data) => T.of(renderDashboard(data))
+  )
+)()
+```
+
+### Retry Failed Operations
+
+```typescript
+import * as T from 'fp-ts/Task'
+import * as TE from 'fp-ts/TaskEither'
+import { pipe } from 'fp-ts/function'
+
+const retry = <E, A>(
+  task: TE.TaskEither<E, A>,
+  attempts: number,
+  delayMs: number
+): TE.TaskEither<E, A> =>
+  pipe(
+    task,
+    TE.orElse((error) =>
+      attempts > 1
+        ? pipe(
+            T.delay(delayMs)(T.of(undefined)),
+            T.chain(() => retry(task, attempts - 1, delayMs * 2))
+          )
+        : TE.left(error)
+    )
+  )
+
+// Retry up to 3 times with exponential backoff
+const fetchWithRetry = retry(fetchUser('123'), 3, 1000)
+```
+
+### Fallback to Alternative
+
+```typescript
+// Try cache first, fall back to API
+const getUserData = (id: string) =>
+  pipe(
+    fetchFromCache(id),
+    TE.orElse(() => fetchFromApi(id)),
+    TE.orElse(() => TE.right(defaultUser)) // Last resort default
+  )
+```
+
+---
+
+## 6. Converting Between Patterns
+
+Real codebases have throwing functions, nullable values, and promises. Here's how to work with them.
+
+### From Nullable to Either
+
+```typescript
+import * as E from 'fp-ts/Either'
+import * as O from 'fp-ts/Option'
+
+// Direct conversion
+const user = users.find(u => u.id === id) // User | undefined
+const result = E.fromNullable('User not found')(user)
+
+// From Option
+const maybeUser: O.Option<User> = O.fromNullable(user)
+const eitherUser = pipe(
+  maybeUser,
+  E.fromOption(() => 'User not found')
+)
+```
+
+### From Throwing Function to Either
+
+```typescript
+// Wrap at the boundary
+const safeParse = <T>(schema: ZodSchema<T>) => (data: unknown): E.Either<ZodError, T> =>
+  E.tryCatch(
+    () => schema.parse(data),
+    (e) => e as ZodError
+  )
+
+// Use throughout your code
+const parseUser = safeParse(UserSchema)
+const result = parseUser(rawData) // Either<ZodError, User>
+```
+
+### From Promise to TaskEither
+
+```typescript
+import * as TE from 'fp-ts/TaskEither'
+
+// Wrap external async functions
+const fetchJson = <T>(url: string): TE.TaskEither<Error, T> =>
+  TE.tryCatch(
+    () => fetch(url).then(r => r.json()),
+    (e) => new Error(`Fetch failed: ${e}`)
+  )
+
+// Wrap axios, prisma, any async library
+const getUserFromDb = (id: string): TE.TaskEither<DbError, User> =>
+  TE.tryCatch(
+    () => prisma.user.findUniqueOrThrow({ where: { id } }),
+    (e) => ({ code: 'DB_ERROR', cause: e })
+  )
+```
+
+### Back to Promise (Escape Hatch)
+
+Sometimes you need a plain Promise for external APIs.
+
+```typescript
+import * as TE from 'fp-ts/TaskEither'
+import * as E from 'fp-ts/Either'
+
+const myTaskEither: TE.TaskEither<Error, User> = fetchUser('123')
+
+// Option 1: Get the Either (preserves both cases)
+const either: E.Either<Error, User> = await myTaskEither()
+
+// Option 2: Throw on error (for legacy code)
+const toThrowingPromise = <E, A>(te: TE.TaskEither<E, A>): Promise<A> =>
+  te().then(E.fold(
+    (error) => Promise.reject(error),
+    (value) => Promise.resolve(value)
+  ))
+
+const user = await toThrowingPromise(fetchUser('123')) // Throws if Left
+
+// Option 3: Default on error
+const user = await pipe(
+  fetchUser('123'),
+  TE.getOrElse(() => T.of(defaultUser))
+)()
+```
+
+---
+
+## Real Scenarios
+
+### Parse User Input Safely
+
+```typescript
+interface ParsedInput {
+  id: number
+  name: string
+  tags: string[]
+}
+
+const parseInput = (raw: unknown): E.Either<string, ParsedInput> =>
+  pipe(
+    E.Do,
+    E.bind('obj', () =>
+      typeof raw === 'object' && raw !== null
+        ? E.right(raw as Record<string, unknown>)
+        : E.left('Input must be an object')
+    ),
+    E.bind('id', ({ obj }) =>
+      typeof obj.id === 'number'
+        ? E.right(obj.id)
+        : E.left('id must be a number')
+    ),
+    E.bind('name', ({ obj }) =>
+      typeof obj.name === 'string' && obj.name.length > 0
+        ? E.right(obj.name)
+        : E.left('name must be a non-empty string')
+    ),
+    E.bind('tags', ({ obj }) =>
+      Array.isArray(obj.tags) && obj.tags.every(t => typeof t === 'string')
+        ? E.right(obj.tags as string[])
+        : E.left('tags must be an array of strings')
+    ),
+    E.map(({ id, name, tags }) => ({ id, name, tags }))
+  )
+
+// Usage
+parseInput({ id: 1, name: 'test', tags: ['a', 'b'] })
+// Right({ id: 1, name: 'test', tags: ['a', 'b'] })
+
+parseInput({ id: 'wrong', name: '', tags: null })
+// Left('id must be a number')
+```
+
+### API Call with Full Error Handling
+
+```typescript
+interface ApiError {
+  code: string
+  message: string
+  status?: number
+}
+
+const createApiError = (message: string, code = 'UNKNOWN', status?: number): ApiError =>
+  ({ code, message, status })
+
+const fetchWithErrorHandling = <T>(url: string): TE.TaskEither<ApiError, T> =>
+  pipe(
+    TE.tryCatch(
+      () => fetch(url),
+      () => createApiError('Network error', 'NETWORK')
+    ),
+    TE.chain(response =>
+      response.ok
+        ? TE.tryCatch(
+            () => response.json() as Promise<T>,
+            () => createApiError('Invalid JSON', 'PARSE')
+          )
+        : TE.left(createApiError(
+            `HTTP ${response.status}`,
+            response.status === 404 ? 'NOT_FOUND' : 'HTTP_ERROR',
+            response.status
+          ))
+    )
+  )
+
+// Usage with pattern matching on error codes
+const handleUserFetch = (userId: string) =>
+  pipe(
+    fetchWithErrorHandling<User>(`/api/users/${userId}`),
+    TE.fold(
+      (error) => {
+        switch (error.code) {
+          case 'NOT_FOUND': return T.of(showNotFoundPage())
+          case 'NETWORK': return T.of(showOfflineMessage())
+          default: return T.of(showGenericError(error.message))
+        }
+      },
+      (user) => T.of(showUserProfile(user))
+    )
+  )
+```
+
+### Process List Where Some Items Might Fail
+
+```typescript
+import * as A from 'fp-ts/Array'
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+interface ProcessResult<T> {
+  successes: T[]
+  failures: Array<{ item: unknown; error: string }>
+}
+
+// Process all, collect successes and failures separately
+const processAllCollectErrors = <T, R>(
+  items: T[],
+  process: (item: T) => E.Either<string, R>
+): ProcessResult<R> => {
+  const results = items.map((item, index) =>
+    pipe(
+      process(item),
+      E.mapLeft(error => ({ item, error, index }))
+    )
+  )
+
+  return {
+    successes: pipe(results, A.filterMap(E.toOption)),
+    failures: pipe(
+      results,
+      A.filterMap(r => E.isLeft(r) ? O.some(r.left) : O.none)
+    )
+  }
+}
+
+// Usage
+const parseNumbers = (inputs: string[]) =>
+  processAllCollectErrors(inputs, input => {
+    const n = parseInt(input, 10)
+    return isNaN(n) ? E.left(`Invalid number: ${input}`) : E.right(n)
+  })
+
+parseNumbers(['1', 'abc', '3', 'def'])
+// {
+//   successes: [1, 3],
+//   failures: [
+//     { item: 'abc', error: 'Invalid number: abc', index: 1 },
+//     { item: 'def', error: 'Invalid number: def', index: 3 }
+//   ]
+// }
+```
+
+### Bulk Operations with Partial Success
+
+```typescript
+import * as TE from 'fp-ts/TaskEither'
+import * as T from 'fp-ts/Task'
+import { pipe } from 'fp-ts/function'
+
+interface BulkResult<T> {
+  succeeded: T[]
+  failed: Array<{ id: string; error: string }>
+}
+
+const bulkProcess = <T>(
+  ids: string[],
+  process: (id: string) => TE.TaskEither<string, T>
+): T.Task<BulkResult<T>> =>
+  pipe(
+    ids,
+    A.map(id =>
+      pipe(
+        process(id),
+        TE.fold(
+          (error) => T.of({ type: 'failed' as const, id, error }),
+          (result) => T.of({ type: 'succeeded' as const, result })
+        )
+      )
+    ),
+    T.sequenceArray,
+    T.map(results => ({
+      succeeded: results
+        .filter((r): r is { type: 'succeeded'; result: T } => r.type === 'succeeded')
+        .map(r => r.result),
+      failed: results
+        .filter((r): r is { type: 'failed'; id: string; error: string } => r.type === 'failed')
+        .map(({ id, error }) => ({ id, error }))
+    }))
+  )
+
+// Usage
+const deleteUsers = (userIds: string[]) =>
+  bulkProcess(userIds, id =>
+    pipe(
+      deleteUser(id),
+      TE.mapLeft(e => e.message)
+    )
+  )
+
+// All operations run, you get a report of what worked and what didn't
+```
+
+---
+
+## Quick Reference
+
+| Pattern | Use When | Example |
+|---------|----------|---------|
+| `E.right(value)` | Creating a success | `E.right(42)` |
+| `E.left(error)` | Creating a failure | `E.left('not found')` |
+| `E.tryCatch(fn, onError)` | Wrapping throwing code | `E.tryCatch(() => JSON.parse(s), toError)` |
+| `E.fromNullable(error)` | Converting nullable | `E.fromNullable('missing')(maybeValue)` |
+| `E.map(fn)` | Transform success | `pipe(result, E.map(x => x * 2))` |
+| `E.mapLeft(fn)` | Transform error | `pipe(result, E.mapLeft(addContext))` |
+| `E.chain(fn)` | Chain operations | `pipe(getA(), E.chain(a => getB(a.id)))` |
+| `E.chainW(fn)` | Chain with different error type | `pipe(validate(), E.chainW(save))` |
+| `E.fold(onError, onSuccess)` | Handle both cases | `E.fold(showError, showData)` |
+| `E.getOrElse(onError)` | Extract with default | `E.getOrElse(() => 0)` |
+| `E.filterOrElse(pred, onFalse)` | Validate with error | `E.filterOrElse(x => x > 0, () => 'must be positive')` |
+| `sequenceS(validation)({...})` | Collect all errors | Form validation |
+
+### TaskEither Equivalents
+
+All Either operations have TaskEither equivalents:
+- `TE.right`, `TE.left`, `TE.tryCatch`
+- `TE.map`, `TE.mapLeft`, `TE.chain`, `TE.chainW`
+- `TE.fold`, `TE.getOrElse`, `TE.filterOrElse`
+- `TE.orElse` for fallbacks
+
+---
+
+## Summary
+
+1. **Return errors as values** - Use Either/TaskEither instead of throwing
+2. **Chain with confidence** - `chain` stops at first error automatically
+3. **Collect all errors when needed** - Use validation applicative for forms
+4. **Wrap at boundaries** - Convert throwing/Promise code at the edges
+5. **Match at the end** - Use `fold` to handle both cases when you're ready to act
+
+The payoff: TypeScript tracks your errors, no more forgotten try/catch, clear control flow, and composable error handling.
--- a/skills/fp-ts-pragmatic/SKILL.md
+++ b/skills/fp-ts-pragmatic/SKILL.md
@@ -0,0 +1,598 @@
+---
+name: fp-ts-pragmatic
+description: A practical, jargon-free guide to fp-ts functional programming - the 80/20 approach that gets results without the academic overhead. Use when writing TypeScript with fp-ts library.
+risk: safe
+source: https://github.com/whatiskadudoing/fp-ts-skills
+---
+
+# Pragmatic Functional Programming
+
+**Read this first.** This guide cuts through the academic jargon and shows you what actually matters. No category theory. No abstract nonsense. Just patterns that make your code better.
+
+## When to Use This Skill
+
+- When starting with fp-ts and need practical guidance
+- When writing TypeScript code that handles nullable values, errors, or async operations
+- When you want cleaner, more maintainable functional code without the academic overhead
+- When refactoring imperative code to functional style
+
+## The Golden Rule
+
+> **If functional programming makes your code harder to read, don't use it.**
+
+FP is a tool, not a religion. Use it when it helps. Skip it when it doesn't.
+
+---
+
+## The 80/20 of FP
+
+These five patterns give you most of the benefits. Master these before exploring anything else.
+
+### 1. Pipe: Chain Operations Clearly
+
+Instead of nesting function calls or creating intermediate variables, chain operations in reading order.
+
+```typescript
+import { pipe } from 'fp-ts/function'
+
+// Before: Hard to read (inside-out)
+const result = format(validate(parse(input)))
+
+// Before: Too many variables
+const parsed = parse(input)
+const validated = validate(parsed)
+const result = format(validated)
+
+// After: Clear, linear flow
+const result = pipe(
+  input,
+  parse,
+  validate,
+  format
+)
+```
+
+**When to use pipe:**
+- 3+ transformations on the same data
+- You find yourself naming throwaway variables
+- Logic reads better top-to-bottom
+
+**When to skip pipe:**
+- Just 1-2 operations (direct call is fine)
+- The operations don't naturally chain
+
+### 2. Option: Handle Missing Values Without null Checks
+
+Stop writing `if (x !== null && x !== undefined)` everywhere.
+
+```typescript
+import * as O from 'fp-ts/Option'
+import { pipe } from 'fp-ts/function'
+
+// Before: Defensive null checking
+function getUserCity(user: User | null): string {
+  if (user === null) return 'Unknown'
+  if (user.address === null) return 'Unknown'
+  if (user.address.city === null) return 'Unknown'
+  return user.address.city
+}
+
+// After: Chain through potential missing values
+const getUserCity = (user: User | null): string =>
+  pipe(
+    O.fromNullable(user),
+    O.flatMap(u => O.fromNullable(u.address)),
+    O.flatMap(a => O.fromNullable(a.city)),
+    O.getOrElse(() => 'Unknown')
+  )
+```
+
+**Plain language translation:**
+- `O.fromNullable(x)` = "wrap this value, treating null/undefined as 'nothing'"
+- `O.flatMap(fn)` = "if we have something, apply this function"
+- `O.getOrElse(() => default)` = "unwrap, or use this default if nothing"
+
+### 3. Either: Make Errors Explicit
+
+Stop throwing exceptions for expected failures. Return errors as values.
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+// Before: Hidden failure mode
+function parseAge(input: string): number {
+  const age = parseInt(input, 10)
+  if (isNaN(age)) throw new Error('Invalid age')
+  if (age < 0) throw new Error('Age cannot be negative')
+  return age
+}
+
+// After: Errors are visible in the type
+function parseAge(input: string): E.Either<string, number> {
+  const age = parseInt(input, 10)
+  if (isNaN(age)) return E.left('Invalid age')
+  if (age < 0) return E.left('Age cannot be negative')
+  return E.right(age)
+}
+
+// Using it
+const result = parseAge(userInput)
+if (E.isRight(result)) {
+  console.log(`Age is ${result.right}`)
+} else {
+  console.log(`Error: ${result.left}`)
+}
+```
+
+**Plain language translation:**
+- `E.right(value)` = "success with this value"
+- `E.left(error)` = "failure with this error"
+- `E.isRight(x)` = "did it succeed?"
+
+### 4. Map: Transform Without Unpacking
+
+Transform values inside containers without extracting them first.
+
+```typescript
+import * as O from 'fp-ts/Option'
+import * as E from 'fp-ts/Either'
+import * as A from 'fp-ts/Array'
+import { pipe } from 'fp-ts/function'
+
+// Transform inside Option
+const maybeUser: O.Option<User> = O.some({ name: 'Alice', age: 30 })
+const maybeName: O.Option<string> = pipe(
+  maybeUser,
+  O.map(user => user.name)
+)
+
+// Transform inside Either
+const result: E.Either<Error, number> = E.right(5)
+const doubled: E.Either<Error, number> = pipe(
+  result,
+  E.map(n => n * 2)
+)
+
+// Transform arrays (same concept!)
+const numbers = [1, 2, 3]
+const doubled = pipe(
+  numbers,
+  A.map(n => n * 2)
+)
+```
+
+### 5. FlatMap: Chain Operations That Might Fail
+
+When each step might fail, chain them together.
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+const parseJSON = (s: string): E.Either<string, unknown> =>
+  E.tryCatch(() => JSON.parse(s), () => 'Invalid JSON')
+
+const extractEmail = (data: unknown): E.Either<string, string> => {
+  if (typeof data === 'object' && data !== null && 'email' in data) {
+    return E.right((data as { email: string }).email)
+  }
+  return E.left('No email field')
+}
+
+const validateEmail = (email: string): E.Either<string, string> =>
+  email.includes('@') ? E.right(email) : E.left('Invalid email format')
+
+// Chain all steps - if any fails, the whole thing fails
+const getValidEmail = (input: string): E.Either<string, string> =>
+  pipe(
+    parseJSON(input),
+    E.flatMap(extractEmail),
+    E.flatMap(validateEmail)
+  )
+
+// Success path: Right('user@example.com')
+// Any failure: Left('specific error message')
+```
+
+**Plain language:** `flatMap` means "if this succeeded, try the next thing"
+
+---
+
+## When NOT to Use FP
+
+Functional programming is not always the answer. Here's when to keep it simple.
+
+### Simple Null Checks
+
+```typescript
+// Just use optional chaining - it's built into the language
+const city = user?.address?.city ?? 'Unknown'
+
+// DON'T overcomplicate it
+const city = pipe(
+  O.fromNullable(user),
+  O.flatMap(u => O.fromNullable(u.address)),
+  O.flatMap(a => O.fromNullable(a.city)),
+  O.getOrElse(() => 'Unknown')
+)
+```
+
+### Simple Loops
+
+```typescript
+// A for loop is fine when you need early exit or complex logic
+function findFirst(items: Item[], predicate: (i: Item) => boolean): Item | null {
+  for (const item of items) {
+    if (predicate(item)) return item
+  }
+  return null
+}
+
+// DON'T force FP when it doesn't help
+const result = pipe(
+  items,
+  A.findFirst(predicate),
+  O.toNullable
+)
+```
+
+### Performance-Critical Code
+
+```typescript
+// For hot paths, imperative is faster (no intermediate arrays)
+function sumLarge(numbers: number[]): number {
+  let sum = 0
+  for (let i = 0; i < numbers.length; i++) {
+    sum += numbers[i]
+  }
+  return sum
+}
+
+// fp-ts creates intermediate structures
+const sum = pipe(numbers, A.reduce(0, (acc, n) => acc + n))
+```
+
+### When Your Team Doesn't Know FP
+
+If you're the only one who can read the code, it's not good code.
+
+```typescript
+// If your team knows this pattern
+async function getUser(id: string): Promise<User | null> {
+  try {
+    const response = await fetch(`/api/users/${id}`)
+    if (!response.ok) return null
+    return await response.json()
+  } catch {
+    return null
+  }
+}
+
+// Don't force this on them
+const getUser = (id: string): TE.TaskEither<Error, User> =>
+  pipe(
+    TE.tryCatch(() => fetch(`/api/users/${id}`), E.toError),
+    TE.flatMap(r => r.ok ? TE.right(r) : TE.left(new Error('Not found'))),
+    TE.flatMap(r => TE.tryCatch(() => r.json(), E.toError))
+  )
+```
+
+---
+
+## Quick Wins: Easy Changes That Improve Code Today
+
+### 1. Replace Nested Ternaries with pipe + fold
+
+```typescript
+// Before: Nested ternary nightmare
+const message = user === null
+  ? 'No user'
+  : user.isAdmin
+    ? `Admin: ${user.name}`
+    : `User: ${user.name}`
+
+// After: Clear case handling
+const message = pipe(
+  O.fromNullable(user),
+  O.fold(
+    () => 'No user',
+    (u) => u.isAdmin ? `Admin: ${u.name}` : `User: ${u.name}`
+  )
+)
+```
+
+### 2. Replace try-catch with tryCatch
+
+```typescript
+// Before: try-catch everywhere
+let config
+try {
+  config = JSON.parse(rawConfig)
+} catch {
+  config = defaultConfig
+}
+
+// After: One-liner
+const config = pipe(
+  E.tryCatch(() => JSON.parse(rawConfig), () => 'parse error'),
+  E.getOrElse(() => defaultConfig)
+)
+```
+
+### 3. Replace undefined Returns with Option
+
+```typescript
+// Before: Caller might forget to check
+function findUser(id: string): User | undefined {
+  return users.find(u => u.id === id)
+}
+
+// After: Type forces caller to handle missing case
+function findUser(id: string): O.Option<User> {
+  return O.fromNullable(users.find(u => u.id === id))
+}
+```
+
+### 4. Replace Error Strings with Typed Errors
+
+```typescript
+// Before: Just strings
+function validate(data: unknown): E.Either<string, User> {
+  // ...
+  return E.left('validation failed')
+}
+
+// After: Structured errors
+type ValidationError = {
+  field: string
+  message: string
+}
+
+function validate(data: unknown): E.Either<ValidationError, User> {
+  // ...
+  return E.left({ field: 'email', message: 'Invalid format' })
+}
+```
+
+### 5. Use const Assertions for Error Types
+
+```typescript
+// Create specific error types without classes
+const NotFound = (id: string) => ({ _tag: 'NotFound' as const, id })
+const Unauthorized = { _tag: 'Unauthorized' as const }
+const ValidationFailed = (errors: string[]) =>
+  ({ _tag: 'ValidationFailed' as const, errors })
+
+type AppError =
+  | ReturnType<typeof NotFound>
+  | typeof Unauthorized
+  | ReturnType<typeof ValidationFailed>
+
+// Now you can pattern match
+const handleError = (error: AppError): string => {
+  switch (error._tag) {
+    case 'NotFound': return `Item ${error.id} not found`
+    case 'Unauthorized': return 'Please log in'
+    case 'ValidationFailed': return error.errors.join(', ')
+  }
+}
+```
+
+---
+
+## Common Refactors: Before and After
+
+### Callback Hell to Pipe
+
+```typescript
+// Before
+fetchUser(id, (user) => {
+  if (!user) return handleNoUser()
+  fetchPosts(user.id, (posts) => {
+    if (!posts) return handleNoPosts()
+    fetchComments(posts[0].id, (comments) => {
+      render(user, posts, comments)
+    })
+  })
+})
+
+// After (with TaskEither for async)
+import * as TE from 'fp-ts/TaskEither'
+
+const loadData = (id: string) =>
+  pipe(
+    fetchUser(id),
+    TE.flatMap(user => pipe(
+      fetchPosts(user.id),
+      TE.map(posts => ({ user, posts }))
+    )),
+    TE.flatMap(({ user, posts }) => pipe(
+      fetchComments(posts[0].id),
+      TE.map(comments => ({ user, posts, comments }))
+    ))
+  )
+
+// Execute
+const result = await loadData('123')()
+pipe(
+  result,
+  E.fold(handleError, ({ user, posts, comments }) => render(user, posts, comments))
+)
+```
+
+### Multiple null Checks to Option Chain
+
+```typescript
+// Before
+function getManagerEmail(employee: Employee): string | null {
+  if (!employee.department) return null
+  if (!employee.department.manager) return null
+  if (!employee.department.manager.email) return null
+  return employee.department.manager.email
+}
+
+// After
+const getManagerEmail = (employee: Employee): O.Option<string> =>
+  pipe(
+    O.fromNullable(employee.department),
+    O.flatMap(d => O.fromNullable(d.manager)),
+    O.flatMap(m => O.fromNullable(m.email))
+  )
+
+// Use it
+pipe(
+  getManagerEmail(employee),
+  O.fold(
+    () => sendToDefault(),
+    (email) => sendTo(email)
+  )
+)
+```
+
+### Validation with Multiple Checks
+
+```typescript
+// Before: Throws on first error
+function validateUser(data: unknown): User {
+  if (!data || typeof data !== 'object') throw new Error('Must be object')
+  const obj = data as Record<string, unknown>
+  if (typeof obj.email !== 'string') throw new Error('Email required')
+  if (!obj.email.includes('@')) throw new Error('Invalid email')
+  if (typeof obj.age !== 'number') throw new Error('Age required')
+  if (obj.age < 0) throw new Error('Age must be positive')
+  return obj as User
+}
+
+// After: Returns first error, type-safe
+const validateUser = (data: unknown): E.Either<string, User> =>
+  pipe(
+    E.Do,
+    E.bind('obj', () =>
+      typeof data === 'object' && data !== null
+        ? E.right(data as Record<string, unknown>)
+        : E.left('Must be object')
+    ),
+    E.bind('email', ({ obj }) =>
+      typeof obj.email === 'string' && obj.email.includes('@')
+        ? E.right(obj.email)
+        : E.left('Valid email required')
+    ),
+    E.bind('age', ({ obj }) =>
+      typeof obj.age === 'number' && obj.age >= 0
+        ? E.right(obj.age)
+        : E.left('Valid age required')
+    ),
+    E.map(({ email, age }) => ({ email, age }))
+  )
+```
+
+### Promise Chain to TaskEither
+
+```typescript
+// Before
+async function processOrder(orderId: string): Promise<Receipt> {
+  const order = await fetchOrder(orderId)
+  if (!order) throw new Error('Order not found')
+
+  const validated = await validateOrder(order)
+  if (!validated.success) throw new Error(validated.error)
+
+  const payment = await processPayment(validated.order)
+  if (!payment.success) throw new Error('Payment failed')
+
+  return generateReceipt(payment)
+}
+
+// After
+const processOrder = (orderId: string): TE.TaskEither<string, Receipt> =>
+  pipe(
+    fetchOrderTE(orderId),
+    TE.flatMap(order =>
+      order ? TE.right(order) : TE.left('Order not found')
+    ),
+    TE.flatMap(validateOrderTE),
+    TE.flatMap(processPaymentTE),
+    TE.map(generateReceipt)
+  )
+```
+
+---
+
+## The Readability Rule
+
+Before using any FP pattern, ask: **"Would a junior developer understand this?"**
+
+### Too Clever (Avoid)
+
+```typescript
+const result = pipe(
+  data,
+  A.filter(flow(prop('status'), equals('active'))),
+  A.map(flow(prop('value'), multiply(2))),
+  A.reduce(monoid.concat, monoid.empty),
+  O.fromPredicate(gt(threshold))
+)
+```
+
+### Just Right (Prefer)
+
+```typescript
+const activeItems = data.filter(item => item.status === 'active')
+const doubledValues = activeItems.map(item => item.value * 2)
+const total = doubledValues.reduce((sum, val) => sum + val, 0)
+const result = total > threshold ? O.some(total) : O.none
+```
+
+### The Middle Ground (Often Best)
+
+```typescript
+const result = pipe(
+  data,
+  A.filter(item => item.status === 'active'),
+  A.map(item => item.value * 2),
+  A.reduce(0, (sum, val) => sum + val),
+  total => total > threshold ? O.some(total) : O.none
+)
+```
+
+---
+
+## Cheat Sheet
+
+| What you want | Plain language | fp-ts |
+|--------------|----------------|-------|
+| Handle null/undefined | "Wrap this nullable" | `O.fromNullable(x)` |
+| Default for missing | "Use this if nothing" | `O.getOrElse(() => default)` |
+| Transform if present | "If something, change it" | `O.map(fn)` |
+| Chain nullable operations | "If something, try this" | `O.flatMap(fn)` |
+| Return success | "Worked, here's the value" | `E.right(value)` |
+| Return failure | "Failed, here's why" | `E.left(error)` |
+| Wrap throwing function | "Try this, catch errors" | `E.tryCatch(fn, onError)` |
+| Handle both cases | "Do this for error, that for success" | `E.fold(onLeft, onRight)` |
+| Chain operations | "Then do this, then that" | `pipe(x, fn1, fn2, fn3)` |
+
+---
+
+## When to Level Up
+
+Once comfortable with these patterns, explore:
+
+1. **TaskEither** - Async operations that can fail (replaces Promise + try/catch)
+2. **Validation** - Collect ALL errors instead of stopping at first
+3. **Reader** - Dependency injection without classes
+4. **Do notation** - Cleaner syntax for multiple bindings
+
+But don't rush. The basics here will handle 80% of real-world scenarios. Get comfortable with these before adding more tools to your belt.
+
+---
+
+## Summary
+
+1. **Use pipe** for 3+ operations
+2. **Use Option** for nullable chains
+3. **Use Either** for operations that can fail
+4. **Use map** to transform wrapped values
+5. **Use flatMap** to chain operations that might fail
+6. **Skip FP** when it hurts readability
+7. **Keep it simple** - if your team can't read it, it's not good code
--- a/skills/fp-ts-react/SKILL.md
+++ b/skills/fp-ts-react/SKILL.md
@@ -0,0 +1,796 @@
+---
+name: fp-ts-react
+description: Practical patterns for using fp-ts with React - hooks, state, forms, data fetching. Use when building React apps with functional programming patterns. Works with React 18/19, Next.js 14/15.
+risk: safe
+source: https://github.com/whatiskadudoing/fp-ts-skills
+---
+
+# Functional Programming in React
+
+Practical patterns for React apps. No jargon, just code that works.
+
+## When to Use This Skill
+
+- When building React apps with fp-ts for type-safe state management
+- When handling loading/error/success states in data fetching
+- When implementing form validation with error accumulation
+- When using React 18/19 or Next.js 14/15 with functional patterns
+
+---
+
+## Quick Reference
+
+| Pattern | Use When |
+|---------|----------|
+| `Option` | Value might be missing (user not loaded yet) |
+| `Either` | Operation might fail (form validation) |
+| `TaskEither` | Async operation might fail (API calls) |
+| `RemoteData` | Need to show loading/error/success states |
+| `pipe` | Chaining multiple transformations |
+
+---
+
+## 1. State with Option (Maybe It's There, Maybe Not)
+
+Use `Option` instead of `null | undefined` for clearer intent.
+
+### Basic Pattern
+
+```typescript
+import { useState } from 'react'
+import * as O from 'fp-ts/Option'
+import { pipe } from 'fp-ts/function'
+
+interface User {
+  id: string
+  name: string
+  email: string
+}
+
+function UserProfile() {
+  // Option says "this might not exist yet"
+  const [user, setUser] = useState<O.Option<User>>(O.none)
+
+  const handleLogin = (userData: User) => {
+    setUser(O.some(userData))
+  }
+
+  const handleLogout = () => {
+    setUser(O.none)
+  }
+
+  return pipe(
+    user,
+    O.match(
+      // When there's no user
+      () => <button onClick={() => handleLogin({ id: '1', name: 'Alice', email: 'alice@example.com' })}>
+        Log In
+      </button>,
+      // When there's a user
+      (u) => (
+        <div>
+          <p>Welcome, {u.name}!</p>
+          <button onClick={handleLogout}>Log Out</button>
+        </div>
+      )
+    )
+  )
+}
+```
+
+### Chaining Optional Values
+
+```typescript
+import * as O from 'fp-ts/Option'
+import { pipe } from 'fp-ts/function'
+
+interface Profile {
+  user: O.Option<{
+    name: string
+    settings: O.Option<{
+      theme: string
+    }>
+  }>
+}
+
+function getTheme(profile: Profile): string {
+  return pipe(
+    profile.user,
+    O.flatMap(u => u.settings),
+    O.map(s => s.theme),
+    O.getOrElse(() => 'light') // default
+  )
+}
+```
+
+---
+
+## 2. Form Validation with Either
+
+Either is perfect for validation: `Left` = errors, `Right` = valid data.
+
+### Simple Form Validation
+
+```typescript
+import * as E from 'fp-ts/Either'
+import * as A from 'fp-ts/Array'
+import { pipe } from 'fp-ts/function'
+
+// Validation functions return Either<ErrorMessage, ValidValue>
+const validateEmail = (email: string): E.Either<string, string> =>
+  email.includes('@')
+    ? E.right(email)
+    : E.left('Invalid email address')
+
+const validatePassword = (password: string): E.Either<string, string> =>
+  password.length >= 8
+    ? E.right(password)
+    : E.left('Password must be at least 8 characters')
+
+const validateName = (name: string): E.Either<string, string> =>
+  name.trim().length > 0
+    ? E.right(name.trim())
+    : E.left('Name is required')
+```
+
+### Collecting All Errors (Not Just First One)
+
+```typescript
+import * as E from 'fp-ts/Either'
+import { sequenceS } from 'fp-ts/Apply'
+import { getSemigroup } from 'fp-ts/NonEmptyArray'
+import { pipe } from 'fp-ts/function'
+
+// This collects ALL errors, not just the first one
+const validateAll = sequenceS(E.getApplicativeValidation(getSemigroup<string>()))
+
+interface SignupForm {
+  name: string
+  email: string
+  password: string
+}
+
+interface ValidatedForm {
+  name: string
+  email: string
+  password: string
+}
+
+function validateForm(form: SignupForm): E.Either<string[], ValidatedForm> {
+  return pipe(
+    validateAll({
+      name: pipe(validateName(form.name), E.mapLeft(e => [e])),
+      email: pipe(validateEmail(form.email), E.mapLeft(e => [e])),
+      password: pipe(validatePassword(form.password), E.mapLeft(e => [e])),
+    })
+  )
+}
+
+// Usage in component
+function SignupForm() {
+  const [form, setForm] = useState({ name: '', email: '', password: '' })
+  const [errors, setErrors] = useState<string[]>([])
+
+  const handleSubmit = () => {
+    pipe(
+      validateForm(form),
+      E.match(
+        (errs) => setErrors(errs),     // Show all errors
+        (valid) => {
+          setErrors([])
+          submitToServer(valid)         // Submit valid data
+        }
+      )
+    )
+  }
+
+  return (
+    <form onSubmit={e => { e.preventDefault(); handleSubmit() }}>
+      <input
+        value={form.name}
+        onChange={e => setForm(f => ({ ...f, name: e.target.value }))}
+        placeholder="Name"
+      />
+      <input
+        value={form.email}
+        onChange={e => setForm(f => ({ ...f, email: e.target.value }))}
+        placeholder="Email"
+      />
+      <input
+        type="password"
+        value={form.password}
+        onChange={e => setForm(f => ({ ...f, password: e.target.value }))}
+        placeholder="Password"
+      />
+
+      {errors.length > 0 && (
+        <ul style={{ color: 'red' }}>
+          {errors.map((err, i) => <li key={i}>{err}</li>)}
+        </ul>
+      )}
+
+      <button type="submit">Sign Up</button>
+    </form>
+  )
+}
+```
+
+### Field-Level Errors (Better UX)
+
+```typescript
+type FieldErrors = Partial<Record<keyof SignupForm, string>>
+
+function validateFormWithFieldErrors(form: SignupForm): E.Either<FieldErrors, ValidatedForm> {
+  const errors: FieldErrors = {}
+
+  pipe(validateName(form.name), E.mapLeft(e => { errors.name = e }))
+  pipe(validateEmail(form.email), E.mapLeft(e => { errors.email = e }))
+  pipe(validatePassword(form.password), E.mapLeft(e => { errors.password = e }))
+
+  return Object.keys(errors).length > 0
+    ? E.left(errors)
+    : E.right({ name: form.name.trim(), email: form.email, password: form.password })
+}
+
+// In component
+{errors.email && <span className="error">{errors.email}</span>}
+```
+
+---
+
+## 3. Data Fetching with TaskEither
+
+TaskEither = async operation that might fail. Perfect for API calls.
+
+### Basic Fetch Hook
+
+```typescript
+import { useState, useEffect } from 'react'
+import * as TE from 'fp-ts/TaskEither'
+import * as E from 'fp-ts/Either'
+import { pipe } from 'fp-ts/function'
+
+// Wrap fetch in TaskEither
+const fetchJson = <T>(url: string): TE.TaskEither<Error, T> =>
+  TE.tryCatch(
+    async () => {
+      const res = await fetch(url)
+      if (!res.ok) throw new Error(`HTTP ${res.status}`)
+      return res.json()
+    },
+    (err) => err instanceof Error ? err : new Error(String(err))
+  )
+
+// Custom hook
+function useFetch<T>(url: string) {
+  const [data, setData] = useState<T | null>(null)
+  const [error, setError] = useState<Error | null>(null)
+  const [loading, setLoading] = useState(true)
+
+  useEffect(() => {
+    setLoading(true)
+    setError(null)
+
+    pipe(
+      fetchJson<T>(url),
+      TE.match(
+        (err) => {
+          setError(err)
+          setLoading(false)
+        },
+        (result) => {
+          setData(result)
+          setLoading(false)
+        }
+      )
+    )()
+  }, [url])
+
+  return { data, error, loading }
+}
+
+// Usage
+function UserList() {
+  const { data, error, loading } = useFetch<User[]>('/api/users')
+
+  if (loading) return <div>Loading...</div>
+  if (error) return <div>Error: {error.message}</div>
+  return (
+    <ul>
+      {data?.map(user => <li key={user.id}>{user.name}</li>)}
+    </ul>
+  )
+}
+```
+
+### Chaining API Calls
+
+```typescript
+// Fetch user, then fetch their posts
+const fetchUserWithPosts = (userId: string) => pipe(
+  fetchJson<User>(`/api/users/${userId}`),
+  TE.flatMap(user => pipe(
+    fetchJson<Post[]>(`/api/users/${userId}/posts`),
+    TE.map(posts => ({ ...user, posts }))
+  ))
+)
+```
+
+### Parallel API Calls
+
+```typescript
+import { sequenceT } from 'fp-ts/Apply'
+
+// Fetch multiple things at once
+const fetchDashboardData = () => pipe(
+  sequenceT(TE.ApplyPar)(
+    fetchJson<User>('/api/user'),
+    fetchJson<Stats>('/api/stats'),
+    fetchJson<Notifications[]>('/api/notifications')
+  ),
+  TE.map(([user, stats, notifications]) => ({
+    user,
+    stats,
+    notifications
+  }))
+)
+```
+
+---
+
+## 4. RemoteData Pattern (The Right Way to Handle Async State)
+
+Stop using `{ data, loading, error }` booleans. Use a proper state machine.
+
+### The Pattern
+
+```typescript
+// RemoteData has exactly 4 states - no impossible combinations
+type RemoteData<E, A> =
+  | { _tag: 'NotAsked' }                    // Haven't started yet
+  | { _tag: 'Loading' }                     // In progress
+  | { _tag: 'Failure'; error: E }           // Failed
+  | { _tag: 'Success'; data: A }            // Got it!
+
+// Constructors
+const notAsked = <E, A>(): RemoteData<E, A> => ({ _tag: 'NotAsked' })
+const loading = <E, A>(): RemoteData<E, A> => ({ _tag: 'Loading' })
+const failure = <E, A>(error: E): RemoteData<E, A> => ({ _tag: 'Failure', error })
+const success = <E, A>(data: A): RemoteData<E, A> => ({ _tag: 'Success', data })
+
+// Pattern match all states
+function fold<E, A, R>(
+  rd: RemoteData<E, A>,
+  onNotAsked: () => R,
+  onLoading: () => R,
+  onFailure: (e: E) => R,
+  onSuccess: (a: A) => R
+): R {
+  switch (rd._tag) {
+    case 'NotAsked': return onNotAsked()
+    case 'Loading': return onLoading()
+    case 'Failure': return onFailure(rd.error)
+    case 'Success': return onSuccess(rd.data)
+  }
+}
+```
+
+### Hook with RemoteData
+
+```typescript
+function useRemoteData<T>(fetchFn: () => Promise<T>) {
+  const [state, setState] = useState<RemoteData<Error, T>>(notAsked())
+
+  const execute = async () => {
+    setState(loading())
+    try {
+      const data = await fetchFn()
+      setState(success(data))
+    } catch (err) {
+      setState(failure(err instanceof Error ? err : new Error(String(err))))
+    }
+  }
+
+  return { state, execute }
+}
+
+// Usage
+function UserProfile({ userId }: { userId: string }) {
+  const { state, execute } = useRemoteData(() =>
+    fetch(`/api/users/${userId}`).then(r => r.json())
+  )
+
+  useEffect(() => { execute() }, [userId])
+
+  return fold(
+    state,
+    () => <button onClick={execute}>Load User</button>,
+    () => <Spinner />,
+    (err) => <ErrorMessage message={err.message} onRetry={execute} />,
+    (user) => <UserCard user={user} />
+  )
+}
+```
+
+### Why RemoteData Beats Booleans
+
+```typescript
+// ❌ BAD: Impossible states are possible
+interface BadState {
+  data: User | null
+  loading: boolean
+  error: Error | null
+}
+// Can have: { data: user, loading: true, error: someError } - what does that mean?!
+
+// ✅ GOOD: Only valid states exist
+type GoodState = RemoteData<Error, User>
+// Can only be: NotAsked | Loading | Failure | Success
+```
+
+---
+
+## 5. Referential Stability (Preventing Re-renders)
+
+fp-ts values like `O.some(1)` create new objects each render. React sees them as "changed".
+
+### The Problem
+
+```typescript
+// ❌ BAD: Creates new Option every render
+function BadComponent() {
+  const [value, setValue] = useState(O.some(1))
+
+  useEffect(() => {
+    // This runs EVERY render because O.some(1) !== O.some(1)
+    console.log('value changed')
+  }, [value])
+}
+```
+
+### Solution 1: useMemo
+
+```typescript
+// ✅ GOOD: Memoize Option creation
+function GoodComponent() {
+  const [rawValue, setRawValue] = useState<number | null>(1)
+
+  const value = useMemo(
+    () => O.fromNullable(rawValue),
+    [rawValue]  // Only recreate when rawValue changes
+  )
+
+  useEffect(() => {
+    // Now this only runs when rawValue actually changes
+    console.log('value changed')
+  }, [rawValue])  // Depend on raw value, not Option
+}
+```
+
+### Solution 2: fp-ts-react-stable-hooks
+
+```bash
+npm install fp-ts-react-stable-hooks
+```
+
+```typescript
+import { useStableO, useStableEffect } from 'fp-ts-react-stable-hooks'
+import * as O from 'fp-ts/Option'
+import * as Eq from 'fp-ts/Eq'
+
+function StableComponent() {
+  // Uses fp-ts equality instead of reference equality
+  const [value, setValue] = useStableO(O.some(1))
+
+  // Effect that understands Option equality
+  useStableEffect(
+    () => { console.log('value changed') },
+    [value],
+    Eq.tuple(O.getEq(Eq.eqNumber))  // Custom equality
+  )
+}
+```
+
+---
+
+## 6. Dependency Injection with Context
+
+Use ReaderTaskEither for testable components with injected dependencies.
+
+### Setup Dependencies
+
+```typescript
+import * as RTE from 'fp-ts/ReaderTaskEither'
+import { pipe } from 'fp-ts/function'
+import { createContext, useContext, ReactNode } from 'react'
+
+// Define what services your app needs
+interface AppDependencies {
+  api: {
+    getUser: (id: string) => Promise<User>
+    updateUser: (id: string, data: Partial<User>) => Promise<User>
+  }
+  analytics: {
+    track: (event: string, data?: object) => void
+  }
+}
+
+// Create context
+const DepsContext = createContext<AppDependencies | null>(null)
+
+// Provider
+function AppProvider({ deps, children }: { deps: AppDependencies; children: ReactNode }) {
+  return <DepsContext.Provider value={deps}>{children}</DepsContext.Provider>
+}
+
+// Hook to use dependencies
+function useDeps(): AppDependencies {
+  const deps = useContext(DepsContext)
+  if (!deps) throw new Error('Missing AppProvider')
+  return deps
+}
+```
+
+### Use in Components
+
+```typescript
+function UserProfile({ userId }: { userId: string }) {
+  const { api, analytics } = useDeps()
+  const [user, setUser] = useState<RemoteData<Error, User>>(notAsked())
+
+  useEffect(() => {
+    setUser(loading())
+    api.getUser(userId)
+      .then(u => {
+        setUser(success(u))
+        analytics.track('user_viewed', { userId })
+      })
+      .catch(e => setUser(failure(e)))
+  }, [userId, api, analytics])
+
+  // render...
+}
+```
+
+### Testing with Mock Dependencies
+
+```typescript
+const mockDeps: AppDependencies = {
+  api: {
+    getUser: jest.fn().mockResolvedValue({ id: '1', name: 'Test User' }),
+    updateUser: jest.fn().mockResolvedValue({ id: '1', name: 'Updated' }),
+  },
+  analytics: {
+    track: jest.fn(),
+  },
+}
+
+test('loads user on mount', async () => {
+  render(
+    <AppProvider deps={mockDeps}>
+      <UserProfile userId="1" />
+    </AppProvider>
+  )
+
+  await screen.findByText('Test User')
+  expect(mockDeps.api.getUser).toHaveBeenCalledWith('1')
+})
+```
+
+---
+
+## 7. React 19 Patterns
+
+### use() for Promises (React 19+)
+
+```typescript
+import { use, Suspense } from 'react'
+
+// Instead of useEffect + useState for data fetching
+function UserProfile({ userPromise }: { userPromise: Promise<User> }) {
+  const user = use(userPromise)  // Suspends until resolved
+  return <div>{user.name}</div>
+}
+
+// Parent provides the promise
+function App() {
+  const userPromise = fetchUser('1')  // Start fetching immediately
+
+  return (
+    <Suspense fallback={<Spinner />}>
+      <UserProfile userPromise={userPromise} />
+    </Suspense>
+  )
+}
+```
+
+### useActionState for Forms (React 19+)
+
+```typescript
+import { useActionState } from 'react'
+import * as E from 'fp-ts/Either'
+
+interface FormState {
+  errors: string[]
+  success: boolean
+}
+
+async function submitForm(
+  prevState: FormState,
+  formData: FormData
+): Promise<FormState> {
+  const data = {
+    email: formData.get('email') as string,
+    password: formData.get('password') as string,
+  }
+
+  // Use Either for validation
+  const result = pipe(
+    validateForm(data),
+    E.match(
+      (errors) => ({ errors, success: false }),
+      async (valid) => {
+        await saveToServer(valid)
+        return { errors: [], success: true }
+      }
+    )
+  )
+
+  return result
+}
+
+function SignupForm() {
+  const [state, formAction, isPending] = useActionState(submitForm, {
+    errors: [],
+    success: false
+  })
+
+  return (
+    <form action={formAction}>
+      <input name="email" type="email" />
+      <input name="password" type="password" />
+
+      {state.errors.map(e => <p key={e} className="error">{e}</p>)}
+
+      <button disabled={isPending}>
+        {isPending ? 'Submitting...' : 'Sign Up'}
+      </button>
+    </form>
+  )
+}
+```
+
+### useOptimistic for Instant Feedback (React 19+)
+
+```typescript
+import { useOptimistic } from 'react'
+
+function TodoList({ todos }: { todos: Todo[] }) {
+  const [optimisticTodos, addOptimisticTodo] = useOptimistic(
+    todos,
+    (state, newTodo: Todo) => [...state, { ...newTodo, pending: true }]
+  )
+
+  const addTodo = async (text: string) => {
+    const newTodo = { id: crypto.randomUUID(), text, done: false }
+
+    // Immediately show in UI
+    addOptimisticTodo(newTodo)
+
+    // Actually save (will reconcile when done)
+    await saveTodo(newTodo)
+  }
+
+  return (
+    <ul>
+      {optimisticTodos.map(todo => (
+        <li key={todo.id} style={{ opacity: todo.pending ? 0.5 : 1 }}>
+          {todo.text}
+        </li>
+      ))}
+    </ul>
+  )
+}
+```
+
+---
+
+## 8. Common Patterns Cheat Sheet
+
+### Render Based on Option
+
+```typescript
+// Pattern 1: match
+pipe(
+  maybeUser,
+  O.match(
+    () => <LoginButton />,
+    (user) => <UserMenu user={user} />
+  )
+)
+
+// Pattern 2: fold (same as match)
+O.fold(
+  () => <LoginButton />,
+  (user) => <UserMenu user={user} />
+)(maybeUser)
+
+// Pattern 3: getOrElse for simple defaults
+const name = pipe(
+  maybeUser,
+  O.map(u => u.name),
+  O.getOrElse(() => 'Guest')
+)
+```
+
+### Render Based on Either
+
+```typescript
+pipe(
+  validationResult,
+  E.match(
+    (errors) => <ErrorList errors={errors} />,
+    (data) => <SuccessMessage data={data} />
+  )
+)
+```
+
+### Safe Array Rendering
+
+```typescript
+import * as A from 'fp-ts/Array'
+
+// Get first item safely
+const firstUser = pipe(
+  users,
+  A.head,
+  O.map(user => <Featured user={user} />),
+  O.getOrElse(() => <NoFeaturedUser />)
+)
+
+// Find specific item
+const adminUser = pipe(
+  users,
+  A.findFirst(u => u.role === 'admin'),
+  O.map(admin => <AdminBadge user={admin} />),
+  O.toNullable  // or O.getOrElse(() => null)
+)
+```
+
+### Conditional Props
+
+```typescript
+// Add props only if value exists
+const modalProps = {
+  isOpen: true,
+  ...pipe(
+    maybeTitle,
+    O.map(title => ({ title })),
+    O.getOrElse(() => ({}))
+  )
+}
+```
+
+---
+
+## When to Use What
+
+| Situation | Use |
+|-----------|-----|
+| Value might not exist | `Option<T>` |
+| Operation might fail (sync) | `Either<E, A>` |
+| Async operation might fail | `TaskEither<E, A>` |
+| Need loading/error/success UI | `RemoteData<E, A>` |
+| Form with multiple validations | `Either` with validation applicative |
+| Dependency injection | Context + `ReaderTaskEither` |
+| Prevent re-renders with fp-ts | `useMemo` or `fp-ts-react-stable-hooks` |
+
+---
+
+## Libraries
+
+- **[fp-ts](https://github.com/gcanti/fp-ts)** - Core library
+- **[fp-ts-react-stable-hooks](https://github.com/mblink/fp-ts-react-stable-hooks)** - Stable hooks
+- **[@devexperts/remote-data-ts](https://github.com/devexperts/remote-data-ts)** - RemoteData
+- **[io-ts](https://github.com/gcanti/io-ts)** - Runtime type validation
+- **[zod](https://github.com/colinhacks/zod)** - Schema validation (works great with fp-ts)
--- a/skills_index.json
+++ b/skills_index.json
@@ -2186,6 +2186,33 @@
    "risk": "unknown",
    "source": "unknown"
  },
+  {
+    "id": "fp-ts-errors",
+    "path": "skills/fp-ts-errors",
+    "category": "uncategorized",
+    "name": "fp-ts-errors",
+    "description": "Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.",
+    "risk": "safe",
+    "source": "https://github.com/whatiskadudoing/fp-ts-skills"
+  },
+  {
+    "id": "fp-ts-pragmatic",
+    "path": "skills/fp-ts-pragmatic",
+    "category": "uncategorized",
+    "name": "fp-ts-pragmatic",
+    "description": "A practical, jargon-free guide to fp-ts functional programming - the 80/20 approach that gets results without the academic overhead. Use when writing TypeScript with fp-ts library.",
+    "risk": "safe",
+    "source": "https://github.com/whatiskadudoing/fp-ts-skills"
+  },
+  {
+    "id": "fp-ts-react",
+    "path": "skills/fp-ts-react",
+    "category": "uncategorized",
+    "name": "fp-ts-react",
+    "description": "Practical patterns for using fp-ts with React - hooks, state, forms, data fetching. Use when building React apps with functional programming patterns. Works with React 18/19, Next.js 14/15.",
+    "risk": "safe",
+    "source": "https://github.com/whatiskadudoing/fp-ts-skills"
+  },
  {
    "id": "framework-migration-code-migrate",
    "path": "skills/framework-migration-code-migrate",
--- a/voltagent_analysis.json
+++ b/voltagent_analysis.json
--- a/voltagent_validation.json
+++ b/voltagent_validation.json
Author	SHA1	Message	Date
sck_0	4acf69d80e	chore: release 4.4.0 - add fp-ts skills (PR #43 )	2026-01-30 20:29:59 +01:00
github-actions[bot]	aaee268672	chore: sync generated registry files [ci skip]	2026-01-30 19:28:08 +00:00
Kadu Maverick	cb9f1b1a4e	feat: add fp-ts skills for TypeScript functional programming (#43 ) Add three practical fp-ts skills: - fp-ts-pragmatic: The 80/20 of functional programming, jargon-free - fp-ts-react: Patterns for using fp-ts with React 18/19 and Next.js - fp-ts-errors: Type-safe error handling with Either and TaskEither Source: https://github.com/whatiskadudoing/fp-ts-skills Co-authored-by: kadu-maverickk <maycon.guedes@itglobers.com>	2026-01-30 20:27:51 +01:00
github-actions[bot]	8b523ccc54	chore: sync generated registry files [ci skip]	2026-01-30 08:24:50 +00:00
sck_0	b831384713	chore: remove temporary analysis files and update .gitignore - Removed temporary report files (_REPORT.md, _COUNT.md) - Removed temporary JSON analysis files - Removed temporary analysis scripts - Added patterns to .gitignore to prevent future commits	2026-01-30 09:24:33 +01:00
sck_0	2128d7b256	chore: resolve merge conflicts and sync generated files [ci skip]	2026-01-30 09:21:51 +01:00
sck_0	10bc6d37d7	chore: sync generated registry files [ci skip]	2026-01-30 09:21:33 +01:00
github-actions[bot]	a53052fcb1	chore: sync generated registry files [ci skip]	2026-01-30 08:18:19 +00:00
sck_0	a53a16e24a	docs: add VoltAgent to Credits & Sources section	2026-01-30 09:18:03 +01:00
sck_0	2250f88e89	docs: update README with correct skill count (614) and add VoltAgent to Credits - Updated all skill count references from 621 to 614 - Added VoltAgent/awesome-agent-skills to Credits & Sources section - All skill count references now consistent	2026-01-30 09:17:58 +01:00
github-actions[bot]	6b377e8549	chore: sync generated registry files [ci skip]	2026-01-30 08:16:36 +00:00
sck_0	92e90552e0	chore: sync generated registry files after merge	2026-01-30 09:15:50 +01:00
github-actions[bot]	4e1ba66df9	chore: sync generated registry files [ci skip]	2026-01-30 07:35:12 +00:00