TechSetupGuides
Intermediateclaudeai-agentsskillscomposiomcp

ComposioHQ/awesome-claude-skills

Set up and contribute to the curated list of 1000+ Claude Skills for AI agents.

  1. Step 1

    Understand the Repository Purpose

    The awesome-claude-skills repository is a comprehensive collection of 1000+ production-ready Claude Skills created by ComposioHQ. It serves as a central hub for discovering, sharing, and contributing skills that extend AI agent capabilities across use cases including document processing, development tools, business automation, and creative workflows.

    Key Statistics:
    - 61,322+ stars on GitHub
    - 1000+ curated skills
    - 78+ SaaS app integrations via Composio
    - 6676+ forks
    - Apache 2.0 license
  2. Step 2

    Clone the Repository

    Clone the awesome-claude-skills repository to your local machine to explore or contribute skills.

    git clone https://github.com/ComposioHQ/awesome-claude-skills.git
    cd awesome-claude-skills
  3. Step 3

    Familiarize Yourself with the Skills Format

    Each skill is a folder containing a SKILL.md file with YAML frontmatter (name, description) and Markdown instructions. Optional bundled resources include scripts/, references/, and assets/ folders.

    Skill Structure:
    skill-name/
    ├── SKILL.md (required)
    │   ├── YAML frontmatter metadata
    │   │   ├── name: (required)
    │   │   ├── description: (required)
    │   │   └── license: (optional)
    │   └── Markdown instructions
    ├── scripts/     (optional) - Executable code
    ├── references/  (optional) - Documentation
    └── assets/      (optional) - Output resources
  4. Step 4

    Install and Configure Claude Code

    Claude Code is the primary tool for running skills locally. Install it from npm or use it through other supported platforms like Claude.ai, Codex, Cursor, or Gemini CLI.

    # Install Claude Code
    npm install -g @anthropic-ai/claude-code
    
    # Verify installation
    claude --version
  5. Step 5

    Set Up Connect Apps Plugin (Optional)

    The connect-apps plugin allows Claude to perform real actions across 500+ apps using Composio. This handles authentication and integrates with services like Gmail, Slack, GitHub, Notion, and more.

    # Install the plugin
    claude --plugin-dir ./connect-apps-plugin
    
    # Run setup (you'll need a Composio API key)
    /connect-apps:setup
    
    # Restart and test
    exit
    claude
    ⚠ Heads up: You need a free API key from dashboard.composio.dev to use the connect-apps plugin.
  6. Step 6

    Explore Existing Skills

    Browse the repository's skills organized by category: Document Processing, Development & Code Tools, Data & Analysis, Business & Marketing, Communication & Writing, Creative & Media, Productivity & Organization, and app automation skills.

    # List all skill directories
    ls -la
    
    # View skill structure examples
    cat template-skill/SKILL.md
    cat skill-creator/SKILL.md
  7. Step 7

    Create a New Skill

    To create a new skill, follow the skill creation process outlined in the skill-creator skill. Start by understanding the concrete examples of how your skill will be used, planning reusable contents, and initializing the skill structure.

    # Initialize a new skill
    mkdir -p my-new-skill
    
    # Create SKILL.md with proper format
    cat > my-new-skill/SKILL.md << 'EOF'
    ---
    name: my-new-skill
    description: A clear description of what this skill does.
    ---
    
    # My New Skill
    
    Detailed instructions and examples.
    EOF
  8. Step 8

    Contribute Your Skill

    Submit your skill by creating a pull request. Ensure your skill is based on a real use case, check for duplicates in existing skills, follow the skill structure template, and test it across multiple platforms.

    # Add your skill to the repository
    git add my-new-skill/
    git commit -m "Add my-new-skill for X functionality"
    git push origin your-branch
    
    # Then create a pull request on GitHub
  9. Step 9

    Use Skills in Different Platforms

    Skills are portable across Claude.ai, Claude Code, the Claude API, Codex, Cursor, Gemini CLI, Antigravity, and Windsurf. Place skills in the appropriate directory for your platform.

    # For Claude Code: place skills in ~/.config/claude-code/skills/
    mkdir -p ~/.config/claude-code/skills/
    cp -r my-new-skill ~/.config/claude-code/skills/
    
    # Verify the skill is recognized
    head ~/.config/claude-code/skills/my-new-skill/SKILL.md

Feature requests

Sign in to suggest features or vote on existing ones.

No feature requests yet.

Discussion

0 people marked this as worked·Sign in to mark your own.

Sign in to join the discussion.

No comments yet.