Awesome AI Skills

Universal AI Workflows for Any LLM, Any IDE, Any Agent

The most comprehensive collection of universal AI skills - reusable workflows for Claude, GPT-4, Llama, Gemini, and any LLM.

Write once, use everywhere. Works with any AI agent, any IDE, any provider.

---

🌟 Repository Attribution

Original by ComposioHQ | Enhanced by Grumpified-OGGVCT

This repository is an enhanced fork that combines:

• 939 automation skills from upstream ComposioHQ/awesome-claude-skills (powered by Composio)
• GrumpiFied enhancements: Universal format support, NLP discovery, automated sync, extended docs, and custom tools
• 🆕 Daily AI Skills Discovery: Automated discovery and integration of universal skills from across GitHub

🔄 Dual Auto-Sync - Two automated workflows keep this repository cutting-edge:

1. Upstream Sync (2 AM UTC) - Syncs with ComposioHQ/awesome-claude-skills
2. 🆕 Universal Skills Discovery (3 AM UTC) - Discovers and integrates new skills from GitHub

Learn more about auto-sync → | Learn about daily discovery → | 📋 Full Attribution Guide

---

🎯 What Is This Repository?

Awesome AI Skills is a curated collection of 939+ ready-to-use AI workflows (called "skills") that teach any AI model how to perform specialized tasks consistently and professionally. Think of skills as expert training modules that transform any general-purpose LLM—Claude, GPT-4, Gemini, Llama, or others—into a domain specialist.

🌍 Truly Universal

Unlike other skill collections tied to specific platforms, these skills work everywhere:

• Any LLM Provider: Claude (Anthropic), GPT-4 (OpenAI), Gemini (Google), Llama (Meta), Mistral, Qwen, and more
• Any Integration: OpenRouter, Ollama, direct APIs, or custom deployments
• Any IDE: VS Code, Cursor, Cline, Continue, Windsurf, or any AI coding assistant
• Any Interface: Web chat, API, CLI tools, or embedded applications

The same skill file works across all platforms—no modifications needed.

What You'll Find Here

• 🎓 Pre-built Skills: 939+ automation skills + 23 universal format skills covering development, business, creative work, and more
• 🌍 Universal Format: 27 skills work with ANY LLM (Claude, GPT-4, Llama, Gemini, etc.)
• 📚 Learning Resources: Guides for creating your own custom skills
• 🛠️ Tools & Scripts: Automation for converting, validating, and testing skills
• 💡 Real-World Examples: Proven workflows from actual users and companies

✨ NEW: Universal Format - Select skills available in OpenAI-compatible format for use with OpenRouter, Ollama, and other LLM providers! See Universal Skills below.

📊 Skills Breakdown

Format	Count	Compatibility	Status
Universal Tier 1	16 skills	✅ Any LLM (Claude, GPT-4, Gemini, Llama, etc.)	🎯 Instruction-based
Universal Tier 2	7 skills	✅ Tool-calling LLMs (Claude 3.5, GPT-4o, Gemini Pro)	🔧 Enhanced with tools
Universal Tier 3	4 skills	⚠️ Claude-only (reference)	📋 Platform-specific
Automation Skills	939 skills	✅ Claude + Composio Rube MCP	🤖 Full automation

Total Skills: 962+ | Universal Coverage: 27 skills work everywhere | Growing: More conversions ongoing

If you want your skills to take actions across 500+ apps, wire them up with Composio

---

👥 Who Is This For?

This repository is perfect for:

• Developers building AI-powered applications with any LLM (Claude, GPT-4, Gemini, etc.)
• IDE Users working with VS Code, Cursor, Cline, Continue, or other AI coding assistants
• Product Teams automating workflows like changelogs, documentation, or competitive research
• Content Creators generating consistent, high-quality content with any AI model
• Business Users leveraging AI for lead research, domain brainstorming, or meeting analysis
• AI Enthusiasts learning how to build effective, portable AI workflows
• Anyone who wants reusable AI skills that work across any platform or provider

---

🚀 Quick Start

🔍 NEW: Can't Find What You Need? Use Skill Discovery!

Problem: "I have to know what to ask for in order to find it."
Solution: Use our discovery tools to find skills by what they do!

🌟 NLP-Enhanced Discovery (Recommended)

Powered by Gemini 3 Flash Preview - understands natural language!

# Set the API key (available in repo secrets)
export OLLAMA_API_KEY='your-key'

# Just describe what you need in plain English
python tools/nlp-discover.py "I need to work with documents"
python tools/nlp-discover.py "help me find domain names"
python tools/nlp-discover.py "tools for my startup"

# Get AI-generated explanations
python tools/nlp-discover.py "pdf tools" --explain

Why NLP is better:

• 🧠 Semantic search - understands intent, not just keywords
• 💡 Query interpretation - clarifies vague searches
• 📝 AI explanations - detailed skill descriptions
• ⚡ Smart recommendations - suggests related skills

Setup: Repository secret OLLAMA_API_KEY is already configured!
For local use, get the key from repo secrets and set as environment variable.

👉 NLP Discovery Guide

📋 Basic Discovery (No API Key Required)

# Super simple wrapper
./tools/find-skill pdf
./tools/find-skill domain name

# Or use Python for more control
python tools/index-skills.py          # Generate index (one-time)
python tools/discover.py              # Interactive mode
python tools/discover.py --search "pdf"
python tools/discover.py --category "Business & Marketing"

👉 Basic Discovery Guide

---

Usage Options: Choose Your Setup

⭐ Recommended: Universal Format (Works Everywhere)

Use skills with any LLM provider and any IDE or interface:

from openai import OpenAI

# Works with OpenRouter, Ollama, direct APIs, or any OpenAI-compatible client
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",  # or http://localhost:11434/v1 for Ollama
    api_key="YOUR_API_KEY"
)

# Load any skill from universal/ directory
with open("universal/tier-1-instruction-only/domain-name-brainstormer/system-prompt.md") as f:
    skill = f.read()

# Use it with ANY model - Claude, GPT-4, Gemini, Llama, etc.!
response = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",  # or "gpt-4o", "google/gemini-pro", "meta-llama/llama-3.2-90b", etc.
    messages=[
        {"role": "system", "content": skill},
        {"role": "user", "content": "Suggest domain names for my AI startup"}
    ]
)

Supports:

• 🤖 Models: Claude, GPT-4, Gemini, Llama, Mistral, Qwen, DeepSeek, and 100+ more
• 🛠️ Platforms: OpenRouter, Ollama, OpenAI, Anthropic, Google AI, or self-hosted
• 💻 IDEs: Use with Continue, Cline, Cursor, Windsurf, or any AI coding assistant
• 🌐 Interfaces: API, CLI, web chat, embedded apps—anywhere

👉 Universal Skills Setup Guide

---

Option 1: Claude.ai (Web Interface)

For quick testing with Claude in your browser:

1. Find a skill using the discovery tool OR browse the Skills section below
2. Pick a skill that matches your needs (e.g., Domain Name Brainstormer)
3. Click the skill icon (🧩) in Claude.ai chat
4. Add the skill or upload the SKILL.md file
5. Claude will automatically use it when relevant!

Example: "Help me brainstorm domain names for my startup" → Claude uses the Domain Name Brainstormer skill

---

Option 2: IDE Integration (VS Code, Cursor, etc.)

Use skills directly in your coding environment:

# For Cursor, Cline, Continue, or other AI assistants
# Copy skill to your IDE's custom instructions directory

# Example with Cursor:
mkdir -p ~/.cursor/prompts/
cp universal/tier-1-instruction-only/domain-name-brainstormer/system-prompt.md ~/.cursor/prompts/

# Example with Continue:
mkdir -p ~/.continue/prompts/
cp universal/tier-1-instruction-only/domain-name-brainstormer/system-prompt.md ~/.continue/prompts/

Works with: VS Code (Continue), Cursor, Cline, Windsurf, and any IDE with AI assistant support

👉 See IDE Setup Guides for your specific editor

---

Option 3: Claude Code (Terminal)

If you use Claude Code specifically:

# Find a skill using discovery tool first!
python tools/discover.py --search "what you need"

# Then install it (example with domain-name-brainstormer)
mkdir -p ~/.config/claude-code/skills/
cp -r domain-name-brainstormer ~/.config/claude-code/skills/

# Start Claude Code - skills load automatically
claude

---

Contents

• 🎯 What Is This Repository?
• 👥 Who Is This For?
• 🚀 Quick Start
  • 🔍 Skill Discovery Tool ⭐ NEW
• 💡 What Are AI Skills?
• Universal LLM Skills Format ✨
• Automated Upstream Sync
• Skills
  • Document Processing
  • Development & Code Tools
  • Data & Analysis
  • Business & Marketing
  • Communication & Writing
  • Creative & Media
  • Productivity & Organization
  • Collaboration & Project Management
  • Security & Systems
• Getting Started
• Creating Skills
• Contributing
• Resources
• 📚 Frequently Asked Questions
• License

👉 New to AI Skills? Start with our comprehensive Getting Started Guide!

💡 What Are AI Skills?

AI Skills (also called "LLM Skills" or "Agent Skills") are structured instruction sets that teach any AI model how to perform specialized tasks consistently and professionally. They're like training manuals for AI—reusable workflows that transform a general-purpose assistant into a domain expert.

These skills work universally across any LLM (Claude, GPT-4, Gemini, Llama, etc.) and any interface (web chat, API, IDE, CLI). Write once, use everywhere.

Real-World Examples

Without a skill:

"Help me come up with a domain name"

AI: "How about mycompany.com or projectname.io?"

With the Domain Name Brainstormer skill:

"Help me come up with a domain name"

AI: "I'll help you brainstorm domain names! First, tell me about your project:

• What does it do?
• Who is it for?
• Any preferred keywords or style?"

[Then generates 15+ creative options, checks availability across multiple TLDs, explains naming rationale, and provides branding insights]

This same skill works identically with Claude, GPT-4, Gemini, Llama, or any other LLM.

Why Use Skills?

• 🎯 Consistency: Get the same high-quality output every time, regardless of which LLM you use
• ⚡ Speed: No need to explain requirements repeatedly—skill handles it
• 🧠 Expertise: Leverage proven workflows from domain experts
• 🔄 Reusability: Write once, use across all platforms and providers
• 📦 Portability: Works with web chat, APIs, IDEs, and CLI tools
• 🌐 Universal: Compatible with any LLM—Claude, GPT-4, Gemini, Llama, and more
• 💻 IDE-Friendly: Integrate with VS Code, Cursor, Cline, Continue, Windsurf, etc.

How Skills Work

1. Instructions: Detailed step-by-step workflows in SKILL.md (universal format)
2. Scripts (optional): Helper tools for complex operations
3. References (optional): Domain knowledge and documentation
4. Assets (optional): Templates, examples, or resources

Skills automatically activate when the AI detects a relevant task, ensuring expertise is applied at the right time—regardless of which model or interface you're using.

---

🚀 GrumpiFied Enhancements

This fork adds powerful enhancements beyond the upstream repository:

🌍 Universal Format Support

Use skills with ANY LLM - Not just Claude!

• ✅ Works with GPT-4, Llama, Gemini, Ollama, OpenRouter, and more
• ✅ Three tiers: Instruction-only, Tool-enhanced, Claude-optimized
• ✅ Automatic conversion tools included
• 📁 Location: universal/ directory | 📖 Learn more

🔍 NLP-Powered Discovery

Find skills by describing what you need - Powered by Gemini AI

• ✅ Natural language search (e.g., "I need to work with documents")
• ✅ AI-generated skill explanations
• ✅ Semantic understanding of user intent
• 🛠️ Tools: tools/nlp-discover.py | 📖 Quick Start

🤖 Automated Sync & QA

Daily automated sync with comprehensive validation

• ✅ Automatic daily sync from upstream (2 AM UTC)
• ✅ Intelligent merge preserving all customizations
• ✅ Security scanning (OpenClaw-style vulnerability detection)
• ✅ YAML validation and auto-repair
• 📖 Learn more

📚 Extended Documentation

Comprehensive guides for all use cases

• Migration guides (Claude → Universal format)
• Multi-provider setup (Ollama, OpenRouter)
• Model compatibility matrices
• Testing procedures
• 📁 Location: docs/ directory

🛠️ Automation Tools

Convert, validate, discover, and test skills

• Skill format converters
• YAML validators
• Skill index generators
• Multi-model testers
• 📁 Location: tools/ directory | 📖 Tools Guide

🎨 Original Custom Skills

Unique skills created by GrumpiFied (not from upstream):

• Content Research Writer
• Domain Name Brainstormer
• Lead Research Assistant
• Meeting Insights Analyzer
• Tailored Resume Generator
• Twitter Algorithm Optimizer
• And more...

📋 See Full Attribution Guide for complete details on what's original vs GrumpiFied.

---

Universal LLM Skills Format

🎯 Skills now work with any OpenAI-compatible LLM!

All skills in this repository are available in a universal format that works with:

• ✅ OpenRouter - Access 100+ models (GPT-4, Claude, Gemini, Llama, etc.) through one API
• ✅ Ollama - Run models locally on your machine (completely free and private)
• ✅ Direct APIs - OpenAI, Anthropic, and other compatible providers

Why Universal Format?

Instead of being locked into Claude-specific features, the universal format uses standard system prompts + tool calling that work everywhere. This means:

• 🌍 One skill, many models - Use the same skill across different LLM providers
• 💰 Cost flexibility - Choose from free, budget, or premium models
• 🔒 Privacy options - Run locally with Ollama or use cloud APIs
• 🚀 Easy migration - Switch providers without rewriting skills

Quick Start

# Example: Using a skill with OpenRouter
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="YOUR_OPENROUTER_KEY"
)

# Load any universal skill
with open("universal/tier-1-instruction-only/domain-name-brainstormer/system-prompt.md") as f:
    system_prompt = f.read()

response = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",  # or any model!
    messages=[
        {"role": "system", "content": system_prompt},
        {"role": "user", "content": "Suggest domain names for a project management tool"}
    ]
)

Three Skill Tiers

Tier 1: Instruction-Only (90% of skills) 📝

• Pure instructions and workflows
• Works with ANY model
• Examples: domain-name-brainstormer, meeting-insights-analyzer, brainstorming

Tier 2: Tool-Enhanced (10% of skills) 🔧

• Includes tool/function calling
• Works best with Claude 3.5, GPT-4o, Gemini 1.5 Pro
• Includes manual fallback for models without tool support
• Examples: pdf editor, file organizer

Tier 3: Claude-Only (Reference) 🎨

• Requires Claude Artifacts or MCP
• Kept as reference for Claude users
• Examples: canvas design, artifacts builder

Documentation

• OpenRouter Setup Guide - Use 100+ models through one API
• Ollama Setup Guide - Run models locally (free & private)
• Model Compatibility Guide - Which models work best for each skill
• Migration Guide - Convert your own skills to universal format

Tools

# Convert skills to universal format
python tools/convert.py --all

# Validate converted skills
python tools/validate.py --all

# Sync with upstream repository
./tools/sync-upstream.sh

Backward Compatibility

✅ Original skills remain unchanged - The universal format is derived from originals ✅ Stays in sync with upstream - Easy to pull updates from ComposioHQ/awesome-claude-skills ✅ No breaking changes - Both formats coexist peacefully

Automated Upstream Sync

This repository automatically stays synchronized with ComposioHQ/awesome-claude-skills while protecting all GrumpiFied enhancements.

How It Works

🤖 Automated Synchronization

• Runs daily at 2 AM UTC to check for upstream updates
• Can also be triggered manually from the Actions tab
• Uses rsync --ignore-existing to preserve local customizations

🛡️ Safety First

• Never overwrites GrumpiFied work - All custom directories are protected:
  • universal/ - Universal LLM Skills Format and conversions
  • tools/ - Custom tools (convert.py, validate.py, nlp-discover.py, etc.)
  • docs/ - Enhanced documentation and guides
  • .github/ - CI/CD workflows
  • All *IMPLEMENTATION*.md, QA-*.md, and custom docs
  • Custom skill folders not in upstream
• Automatic PR creation - Creates detailed PR with QA reports for review
• Comprehensive validation - YAML checks, security scans, integrity tests

What Gets Synced

✅ New automation skills from ComposioHQ/awesome-claude-skills
✅ Updates to existing Composio skills from upstream
✅ Bug fixes and improvements from the official repository

❌ Never synced (protected GrumpiFied content):

• Universal format conversions in universal/
• Custom tools and scripts in tools/
• Enhanced documentation in docs/
• CI/CD workflows in .github/
• README.md and all custom documentation files
• Custom skills not in upstream (domain-name-brainstormer, meeting-insights-analyzer, etc.)

Manual Sync (Fallback)

You can always sync manually using the provided script:

# Interactive manual sync with safety checks
./tools/sync-upstream.sh

This script:

• Creates a backup branch before syncing
• Shows you what will be merged before proceeding
• Prompts for confirmation at each step
• Preserves all GrumpiFied customizations

When Human Review Is Needed

The automation creates a pull request when:

• 🔄 Upstream updates detected - New skills or changes available
• ✅ QA validation passes - All checks successful
• ⚠️ Warnings detected - Minor issues found (review recommended)
• ❌ Critical issues - Validation failures requiring attention

Simply review the auto-generated PR with detailed QA reports and merge when ready.

Monitoring

Check the Actions tab to:

• View sync history and results
• Manually trigger a sync
• Check for any auto-generated PRs needing review

📖 Full Sync Documentation | 📋 Sync History

Skills

Document Processing

• docx - Create, edit, analyze Word docs with tracked changes, comments, formatting.
• pdf - Extract text, tables, metadata, merge & annotate PDFs.
• pptx - Read, generate, and adjust slides, layouts, templates.
• xlsx - Spreadsheet manipulation: formulas, charts, data transformations.
• Markdown to EPUB Converter - Converts markdown documents and chat summaries into professional EPUB ebook files. By @smerchek

Development & Code Tools

• artifacts-builder - Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui).
• aws-skills - AWS development with CDK best practices, cost optimization MCP servers, and serverless/event-driven architecture patterns.
• Changelog Generator - Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes.
• Claude Code Terminal Title - Gives each Claud-Code terminal window a dynamic title that describes the work being done so you don't lose track of what window is doing what.
• D3.js Visualization - Teaches Claude to produce D3 charts and interactive data visualizations. By @chrisvoncsefalvay
• FFUF Web Fuzzing - Integrates the ffuf web fuzzer so Claude can run fuzzing tasks and analyze results for vulnerabilities. By @jthack
• finishing-a-development-branch - Guides completion of development work by presenting clear options and handling chosen workflow.
• iOS Simulator - Enables Claude to interact with iOS Simulator for testing and debugging iOS applications. By @conorluddy
• MCP Builder - Guides creation of high-quality MCP (Model Context Protocol) servers for integrating external APIs and services with LLMs using Python or TypeScript.
• move-code-quality-skill - Analyzes Move language packages against the official Move Book Code Quality Checklist for Move 2024 Edition compliance and best practices.
• Playwright Browser Automation - Model-invoked Playwright automation for testing and validating web applications. By @lackeyjb
• prompt-engineering - Teaches well-known prompt engineering techniques and patterns, including Anthropic best practices and agent persuasion principles.
• pypict-claude-skill - Design comprehensive test cases using PICT (Pairwise Independent Combinatorial Testing) for requirements or code, generating optimized test suites with pairwise coverage.
• Skill Creator - Provides guidance for creating effective Claude Skills that extend capabilities with specialized knowledge, workflows, and tool integrations.
• Skill Seekers - Automatically converts any documentation website into a Claude AI skill in minutes. By @yusufkaraaslan
• software-architecture - Implements design patterns including Clean Architecture, SOLID principles, and comprehensive software design best practices.
• subagent-driven-development - Dispatches independent subagents for individual tasks with code review checkpoints between iterations for rapid, controlled development.
• test-driven-development - Use when implementing any feature or bugfix, before writing implementation code.
• using-git-worktrees - Creates isolated git worktrees with smart directory selection and safety verification.
• Webapp Testing - Tests local web applications using Playwright for verifying frontend functionality, debugging UI behavior, and capturing screenshots.

Data & Analysis

• CSV Data Summarizer - Automatically analyzes CSV files and generates comprehensive insights with visualizations without requiring user prompts. By @coffeefuelbump
• root-cause-tracing - Use when errors occur deep in execution and you need to trace back to find the original trigger.

Business & Marketing

• Brand Guidelines - Applies Anthropic's official brand colors and typography to artifacts for consistent visual identity and professional design standards.
• Competitive Ads Extractor - Extracts and analyzes competitors' ads from ad libraries to understand messaging and creative approaches that resonate.
• Domain Name Brainstormer - Generates creative domain name ideas and checks availability across multiple TLDs including .com, .io, .dev, and .ai extensions.
• Internal Comms - Helps write internal communications including 3P updates, company newsletters, FAQs, status reports, and project updates using company-specific formats.
• Lead Research Assistant - Identifies and qualifies high-quality leads by analyzing your product, searching for target companies, and providing actionable outreach strategies.

Communication & Writing

• article-extractor - Extract full article text and metadata from web pages.
• brainstorming - Transform rough ideas into fully-formed designs through structured questioning and alternative exploration.
• Content Research Writer - Assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
• family-history-research - Provides assistance with planning family history and genealogy research projects.
• Meeting Insights Analyzer - Analyzes meeting transcripts to uncover behavioral patterns including conflict avoidance, speaking ratios, filler words, and leadership style.
• NotebookLM Integration - Lets Claude Code chat directly with NotebookLM for source-grounded answers based exclusively on uploaded documents. By @PleasePrompto

Creative & Media

• Canvas Design - Creates beautiful visual art in PNG and PDF documents using design philosophy and aesthetic principles for posters, designs, and static pieces.
• Image Enhancer - Improves image and screenshot quality by enhancing resolution, sharpness, and clarity for professional presentations and documentation.
• Slack GIF Creator - Creates animated GIFs optimized for Slack with validators for size constraints and composable animation primitives.
• Theme Factory - Applies professional font and color themes to artifacts including slides, docs, reports, and HTML landing pages with 10 pre-set themes.
• Video Downloader - Downloads videos from YouTube and other platforms for offline viewing, editing, or archival with support for various formats and quality options.
• youtube-transcript - Fetch transcripts from YouTube videos and prepare summaries.

Productivity & Organization

• File Organizer - Intelligently organizes files and folders by understanding context, finding duplicates, and suggesting better organizational structures.
• Invoice Organizer - Automatically organizes invoices and receipts for tax preparation by reading files, extracting information, and renaming consistently.
• kaizen - Applies continuous improvement methodology with multiple analytical approaches, based on Japanese Kaizen philosophy and Lean methodology.
• n8n-skills - Enables AI assistants to directly understand and operate n8n workflows.
• Raffle Winner Picker - Randomly selects winners from lists, spreadsheets, or Google Sheets for giveaways and contests with cryptographically secure randomness.
• ship-learn-next - Skill to help iterate on what to build or learn next, based on feedback loops.
• tapestry - Interlink and summarize related documents into knowledge networks.

Collaboration & Project Management

• git-pushing - Automate git operations and repository interactions.
• review-implementing - Evaluate code implementation plans and align with specs.
• test-fixing - Detect failing tests and propose patches or fixes.

Security & Systems

• computer-forensics - Digital forensics analysis and investigation techniques.
• file-deletion - Secure file deletion and data sanitization methods.
• metadata-extraction - Extract and analyze file metadata for forensic purposes.
• threat-hunting-with-sigma-rules - Use Sigma detection rules to hunt for threats and analyze security events.

Getting Started

Step-by-Step Guides

Using Skills in Claude.ai

1. Open Claude.ai and start a new conversation
2. Click the skill icon (🧩) in the chat interface
3. Browse the marketplace or click "Add custom skill"
4. Upload a SKILL.md file from this repository (or select from marketplace)
5. Start chatting - Claude automatically activates relevant skills based on your task

Example workflow:

You: "Help me brainstorm domain names for my startup"
Claude: [Automatically uses Domain Name Brainstormer skill]
         "I'll help you find the perfect domain! Tell me about your startup..."

Using Skills in Claude Code

Installation:

# Create skills directory
mkdir -p ~/.config/claude-code/skills/

# Copy a skill (example: domain-name-brainstormer)
cp -r domain-name-brainstormer ~/.config/claude-code/skills/

# Or clone the entire repository for all skills
cd ~/.config/claude-code/skills/
git clone https://github.com/Grumpified-OGGVCT/awesome-claude-skills.git .

Verify installation:

# Check the skill metadata
head ~/.config/claude-code/skills/domain-name-brainstormer/SKILL.md

# You should see YAML frontmatter with name and description

Usage:

# Start Claude Code (skills load automatically)
claude

# Skills activate when relevant
# Example: Working on a new project triggers domain-name-brainstormer

Using Skills via API

Basic example:

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    skills=["skill-id-here"],  # Skill IDs from marketplace
    messages=[{"role": "user", "content": "Your prompt"}]
)

print(response.content)

With custom skills:

# First, upload your skill to get a skill_id
# Then reference it in the skills parameter
response = client.messages.create(
    model="claude-3-5-sonnet-20241022", 
    skills=["your-custom-skill-id"],
    messages=[{"role": "user", "content": "Task that uses your skill"}]
)

See the Skills API documentation for complete details including skill upload, management, and advanced usage.

Creating Skills

Skill Structure

Each skill is a folder containing a SKILL.md file with YAML frontmatter:

skill-name/
├── SKILL.md          # Required: Skill instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

Basic Skill Template

---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---

# My Skill Name

Detailed description of the skill's purpose and capabilities.

## When to Use This Skill

- Use case 1
- Use case 2
- Use case 3

## Instructions

[Detailed instructions for Claude on how to execute this skill]

## Examples

[Real-world examples showing the skill in action]

Skill Best Practices

• Focus on specific, repeatable tasks
• Include clear examples and edge cases
• Write instructions for Claude, not end users
• Test across Claude.ai, Claude Code, and API
• Document prerequisites and dependencies
• Include error handling guidance

Contributing

We welcome contributions! Please read our Contributing Guidelines for details on:

• How to submit new skills
• Skill quality standards
• Pull request process
• Code of conduct

Quick Contribution Steps

1. Ensure your skill is based on a real use case
2. Check for duplicates in existing skills
3. Follow the skill structure template
4. Test your skill across platforms
5. Submit a pull request with clear documentation

Resources

Official Documentation

• Claude Skills Overview - Official announcement and features
• Skills User Guide - How to use skills in Claude
• Creating Custom Skills - Skill development guide
• Skills API Documentation - API integration guide
• Agent Skills Blog Post - Engineering deep dive

Community Resources

• Anthropic Skills Repository - Official Anthropic example skills
• ComposioHQ Skills Repository - Upstream source for automation skills in this fork
• Claude Community - Discuss skills with other users
• Skills Marketplace - Discover and share skills

Inspiration & Use Cases

• Lenny's Newsletter - 50 ways people use Claude Code
• Notion Skills - Notion integration skills

Join the Community

• Have questions about integrating Composio with your auth setup? Hop on a quick call with us
• Follow us on Twitter
• Join our Discord

---

📚 Frequently Asked Questions

General Questions

Q: What exactly are Claude Skills?
A: Skills are structured instruction sets (like training manuals) that teach AI models how to perform specialized tasks consistently. They contain workflows, best practices, and sometimes helper scripts to ensure high-quality, repeatable results.

Q: Do I need to be technical to use skills?
A: No! Most users can simply upload a SKILL.md file to Claude.ai and start using it. Technical users can leverage advanced features like API integration and custom skill development.

Q: Are skills only for Claude?
A: Originally yes, but this repository now includes a Universal Format that works with any OpenAI-compatible LLM including GPT-4, Llama, Gemini, and others via OpenRouter or Ollama.

Q: How is this different from just writing a good prompt?
A: Skills are more comprehensive than prompts. They include:

• Multi-step workflows and decision trees
• Domain-specific knowledge and best practices
• Helper scripts for complex operations
• Templates and examples
• Automatic activation when relevant
• Reusability across platforms

Using Skills

Q: How do I know which skill to use?
A: Browse the Skills section organized by category (Development, Business, Creative, etc.). Each skill includes a clear description of what it does and when to use it.

Q: Can I use multiple skills at once?
A: Yes! Claude can use multiple skills in a single conversation. Each skill activates when relevant to the current task.

Q: Do skills work offline?
A: Skills for Claude.ai and Claude API require internet. However, with the Universal Format and Ollama, you can run skills completely locally and offline.

Q: How much do skills cost?
A: Skills themselves are free and open source. You only pay for the LLM service you use:

• Claude.ai: Free tier or paid subscription
• Claude Code: Requires Claude API access
• Universal Format: Free with Ollama (local) or paid with cloud providers (OpenRouter, OpenAI, etc.)

Creating Skills

Q: Can I create my own skills?
A: Absolutely! See Creating Skills and check out the Skill Creator skill for guidance.

Q: How do I share my skill with others?
A: Submit a pull request to this repository! See Contributing for guidelines. You can also share the SKILL.md file directly.

Q: What makes a good skill?
A: Good skills:

• Solve specific, real-world problems
• Include clear, step-by-step instructions
• Provide examples and use cases
• Work consistently across platforms
• Are well-documented

Technical Questions

Q: What's the difference between the skill tiers?
A:

• Tier 1 (90% of skills): Instruction-only, works with ANY model
• Tier 2 (10% of skills): Includes tool/function calling, works best with advanced models
• Tier 3: Claude-specific features (Artifacts, MCP)

Q: How do I convert a Claude skill to universal format?
A: Use the conversion tool:

python tools/convert.py --skill skill-name

See UNIVERSAL-FORMAT.md for details.

Q: Can I use skills with my company's private data?
A: Yes! Skills are just instruction sets. When using Ollama locally, everything stays on your machine. With cloud APIs, follow your organization's data policies.

Q: How do I test if a skill works with different models?
A: Use the model tester:

python tools/model-tester.py --skill path/to/skill --providers openrouter ollama

Troubleshooting

Q: My skill isn't activating. What's wrong?
A: Common issues:

1. Check metadata: Ensure YAML frontmatter has clear name and description
2. File location: Verify skill is in correct directory (~/.config/claude-code/skills/)
3. File name: Must be SKILL.md (uppercase)
4. Relevance: Make sure your task matches the skill's description

Q: Can I modify existing skills?
A: Yes! Skills are open source. Fork the skill, modify it for your needs, and use it. Consider contributing improvements back to the community.

Q: Where can I get help?
A:

• Open an issue on GitHub
• Check Claude Community
• Join the Composio Discord
• Read the official Claude Skills documentation

Contributing

Q: How can I contribute?
A: Several ways:

• Submit new skills via pull request
• Improve existing skills
• Add documentation or examples
• Report bugs or suggest features
• Share your use cases and workflows

See CONTRIBUTING.md for detailed guidelines.

---

License

This repository is licensed under the Apache License 2.0.

Individual skills may have different licenses - please check each skill's folder for specific licensing information.

---

🙏 Attribution & Acknowledgments

This repository is an enhanced fork that combines the best of both worlds:

🌳 Upstream Original

939 automation skills from ComposioHQ/awesome-claude-skills

• Powered by Composio platform
• Complete toolkit ecosystem (874 Composio toolkits)
• Apache 2.0 License

🚀 GrumpiFied Enhancements

Custom additions by Grumpified-OGGVCT:

• ✅ Universal format support (works with 100+ LLM models)
• ✅ NLP-powered skill discovery (Gemini AI)
• ✅ Automated daily sync with QA validation
• ✅ Extended documentation & guides
• ✅ Multi-provider examples (OpenRouter, Ollama)
• ✅ Automation tools (convert, validate, discover)
• ✅ Security scanning & quality assurance

🔄 Auto-Synced Daily - This fork automatically syncs with upstream every day while preserving all GrumpiFied features.

📋 Full Attribution Guide - Complete breakdown of original vs GrumpiFied content

---

🌟 Original by ComposioHQ | 🚀 Enhanced by Grumpified-OGGVCT

Bringing together the best automation skills from Composio with universal format support for all LLM providers

---

Note: Claude Skills work across Claude.ai, Claude Code, and the Claude API. Once you create a skill, it's portable across all platforms, making your workflows consistent everywhere you use Claude.

• AgentsKB - Upgrade your AI with researched answers. We did the research so your AI gets it right the first time.