Loading skills catalog...

🔍
Provider:
Category:
Type:
- Total Skills
- Providers
- Categories
- Showing
Loading skills...

## 🔄 Detected Duplicates (≥80% Similar)

These skills were identified as near-duplicates of official sources and are shown for transparency. We keep the highest-quality version from the official provider.

## 🌟 Have a Skill Repository?

We aggregate skills from trusted sources. Submit your repository to be included in the directory.

➕ Request New Source

## 📦 Curated Skill Bundles

Pre-configured collections of skills grouped by use case. Install an entire stack with one command!

Category:
- bundles available
Loading bundles...

## 🌐 Ecosystem Exports

Pre-filtered skill catalogs optimized for different AI ecosystems. Use these endpoints directly in your tools, MCP servers, or integrations.

🤖

### Claude Skills

-

High-quality skills (score ≥ 50) compatible with Claude Code

    cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/claude-skills.json

🐙

### Copilot Skills

-

High-quality skills (score ≥ 50) compatible with GitHub Copilot

    cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/copilot-skills.json

🔗

### MCP-Compatible

-

Skills with MCP integration support

    cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/mcp-compatible.json

⭐

### Premium Skills

-

Top-quality skills with score ≥ 70

    cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/premium-skills.json

🟢

### Active Skills

-

Recently maintained skills (updated within 6 months)

    cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/active-skills.json

## 🏷️ Badges for Skill Authors

Add these badges to your repository README to show your skill is listed in the Agent Skills Directory.

### 📌 "Listed on" Badge

Show that your skill is part of the curated directory:

    [![Listed on Agent Skills Directory](https://img.shields.io/badge/Listed_on-Agent_Skills_Directory-6366f1?style=flat)](https://dmgrok.github.io/agent_skills_directory/)

### 📊 Dynamic Catalog Badges

Live-updating badges powered by shields.io endpoints:

    ![Skills](https://img.shields.io/endpoint?url=https://cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/badge-skills.json)
    ![Providers](https://img.shields.io/endpoint?url=https://cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/badge-providers.json)
    ![Quality](https://img.shields.io/endpoint?url=https://cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/badge-quality.json)

### ⭐ Quality Score Badge

Show your skill's quality score (replace `{score}` and `{color}`):

Your quality score:

## 🔌 Validate Your Skill

Every skill submitted to the directory goes through a comprehensive automated validation pipeline. Use our reusable GitHub Action to validate locally, or submit and our pipeline handles the rest.

### 🛡️ Validation Pipeline — All Checks We Run

1
📄 YAML Frontmatter Validation
Parses the `---` frontmatter block in SKILL.md. Validates structure, required fields, and correct types. A malformed YAML block or missing required field is an immediate hard failure.
`name` present `description` present `category` present `tags` is array `version` present `globs` optional valid YAML syntax no duplicate keys
Required
2
🏷️ Naming & Format Conventions
Validates skill name format and version string. Reserved generic names are flagged to keep the catalog meaningful.
lowercase only alphanumeric + hyphens 2–50 chars no leading/trailing hyphen no reserved names `test, demo, sample, app…` semver 2.0 version description 10–200 chars ≤10 keywords known runtime known capabilities LICENSE present
Required
3
📝 Content Quality Analysis
Analyzes the instruction body for completeness. Detects placeholder / template text that was never filled in, and checks for recommended structural sections and code examples.
≥100 chars total body ≥50 words no `TODO` no `FIXME` no `TBD` no Lorem ipsum no "placeholder" text no "add your content here" Usage / How to use section Examples section fenced code blocks <5000 words (not too long)
Quality
4
🔒 Secrets Detection — 30+ Patterns
Two-layer scan. Primary: detect-secrets (Yelp) with entropy-based detection and 20+ provider-specific plugins. Fallback: built-in regex patterns for 30+ known secret formats. Also runs gitleaks v8 against the full repository tree.
OpenAI `sk-…` / `sk-proj-…` Anthropic `sk-ant-api…` GitHub PAT `ghp_…` GitHub OAuth `gho_…` GitHub fine-grained `github_pat_…` GitHub App `ghu_/ghs_` AWS Access Key `AKIA…` AWS Secret Key (entropy) Google API `AIza…` Google OAuth `ya29.…` Slack bot `xoxb-…` Slack webhook URL Stripe live `sk_live_…` Stripe test `sk_test_…` Discord bot token Discord webhook URL npm token `npm_…` PyPI token `pypi-AgE…` Twilio API `SK…` SendGrid `SG.…` Private key PEM header generic `api_key=…` generic `secret=…` generic `token=…` Base64 high-entropy strings Hex high-entropy strings JWT tokens gitleaks full-repo scan
Required
5
🛡️ Injection & Malicious Pattern Detection
Scans skill instructions for patterns that could cause an AI agent to execute dangerous operations. Covers shell injection, code injection, RCE, obfuscation, and data exfiltration vectors.
destructive `rm -rf /` targeting system dirs pipe-to-shell `curl … | bash` pipe-to-shell `wget … | sh` pipe-to-python `curl … | python3` code injection `eval(input(…))` code injection `exec(request.…)` dynamic import `__import__(argv)` shell injection `subprocess(shell=True)` SQL injection via string concat obfuscation `base64.decode → exec` prompt injection attempts jailbreak instructions
Lakera Guard AI is also optionally used to detect prompt-injection in skill content.
Required
6
⭐ LGTM Quality Scoring (0–100)
Automated quality assessment using the LGTM Agent Skills action. Minimum score: 70/100 to pass. Sub-scores are weighted and visible in the PR comment.
Spec Compliance Security KPI Content Quality Testing coverage Originality score <70 → fail score 70–84 → manual review score ≥85 → auto-approve
Automated
7
🔄 Duplicate & Similarity Check
Checks the full catalog for exact name clashes and near-duplicates. Uses rapidfuzz (C-optimized) → python-Levenshtein → pure-Python fallback for the similarity calculation. Top-3 similar names are surfaced in the report.
exact name match → block Levenshtein similarity >80% → warn top-3 similar names reported mirror / fork detection normalized similarity ratio (0–1)
Quality
8
🧪 Provider Integration Test
Live end-to-end test against the actual repository. Confirms the provider config resolves correctly, files are reachable, and at least one valid SKILL.md can be parsed before the PR is created.
GitHub API tree fetch recursive tree traversal SKILL.md reachable via raw URL frontmatter parseable skills_path_prefix valid branch exists (main/master) rate-limit check (needs GITHUB_TOKEN)
Automated

### 🔧 Run Validation in Your Repo

    # .github/workflows/validate.yml
    name: Validate Skill
    on: [push, pull_request]
    jobs:
      validate:
        uses: dmgrok/agent_skills_directory/.github/workflows/validate-skill.yml@main
        with:
          skill-path: '.'

This validates frontmatter schema, required fields, content length, and scans for leaked secrets. On success, it suggests a badge to add to your README.

## 📡 Distribution Channels

The Agent Skills Directory is available through multiple distribution channels for maximum reach.

### 🌐 CDN (jsDelivr)

Direct JSON access via CDN. Zero setup, instant integration.

`cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.json`

### ⚡ CLI Tool

npm-like package manager. Search, install, manage skills.

`brew install dmgrok/tap/skills`

### 🤖 MCP Server

Mother Skills MCP for auto-detection and installation.

`github.com/dmgrok/mcp_mother_skills`

### 🐍 PyPI

Python package installation for CLI access.

`pip install agent-skills-directory`

### 📦 GitHub Releases

Versioned releases with vYYYY.MM.DD tags.

`github.com/dmgrok/agent_skills_directory/releases`

### 🔍 Web Browser

This site! Browse, search, filter, and install skills.

`dmgrok.github.io/agent_skills_directory`

## ⚡ Skills CLI

The package manager for AI agent skills. Search, install, and manage skills from your terminal—just like npm for packages.

### macOS Installation

Recommended

#### 🍺 Homebrew

    brew install dmgrok/tap/skills

#### ⚡ Quick Install Script

    curl -fsSL https://raw.githubusercontent.com/dmgrok/agent_skills_directory/main/install.sh | sh

#### 📥 Direct Download

Download for macOS (ARM64 & Intel)

### Linux Installation

Recommended

#### ⚡ Quick Install Script

    curl -fsSL https://raw.githubusercontent.com/dmgrok/agent_skills_directory/main/install.sh | sh

#### 🍺 Homebrew (if installed)

    brew install dmgrok/tap/skillsdir

#### 📥 Direct Download

Download for Linux (x64)

### Windows Installation

Recommended

#### 📥 Direct Download

Download for Windows (x64)

After downloading, add the executable to your PATH or run from the download location.

### Install from Source (Python Required)

#### 🐍 pip install (editable)

    git clone https://github.com/dmgrok/agent_skills_directory.git
    cd agent_skills_directory && pip install -e .

### 🛠️ Command Reference

#### `skillsdir search <query>`

Discovery

Search for skills by name, description, or tags

    $ skillsdir search "web scraping"
    Found 5 skill(s):

      anthropic/web-researcher
      Advanced web research and data extraction
      #web #research #scraping

      github/browser-use
      Browser automation for web interaction
      #browser #automation #web

#### `skillsdir info <skill-id>`

Discovery

View detailed information about a skill

    $ skillsdir info anthropic/pdf

    pdf
    ────────────────────────────────────────
      id:          anthropic/pdf
      provider:    anthropics
      category:    documents
      description: Process and analyze PDF documents
      tags:        pdf, documents, extraction
      repo:        https://github.com/anthropics/skills

      Not installed. Run: skillsdir install anthropic/pdf

#### `skillsdir install <skill-id>`

Install

Install a skill to `~/.skills/installed/` (global) or project directory

    $ skillsdir install github/web-design-reviewer
    → Installing github/web-design-reviewer...
    ✓ Installed github/web-design-reviewer → ~/.skills/installed/github/web-design-reviewer

    # Install a specific version
    $ skillsdir install anthropic/pdf@1.2.0

    # Force reinstall
    $ skillsdir install anthropic/pdf --force

    # Global install (default)
    $ skillsdir install anthropic/pdf
    → Installing anthropics/pdf [global]...
    ✓ Installed anthropics/pdf → ~/.skills/installed/anthropics/pdf

    # Project install (auto-detects agent)
    $ skillsdir install anthropic/pdf --project
    → Installing anthropics/pdf [project (copilot)]...
    ✓ Installed anthropics/pdf → .github/skills/pdf
    → Tip: Reference this skill in your .github/copilot-instructions.md

    # Project install with specific agent
    $ skillsdir install anthropic/pdf -p --agent claude
    → Installing anthropics/pdf [project (claude)]...
    ✓ Installed anthropics/pdf → .claude/skills/pdf
    → Tip: Reference this skill in your CLAUDE.md

    # Other agents
    $ skillsdir install anthropic/pdf -p --agent copilot  # .github/skills/
    $ skillsdir install anthropic/pdf -p --agent codex    # .codex/skills/
    $ skillsdir install anthropic/pdf -p --agent cursor   # .cursor/skills/

#### `skillsdir detect`

Discovery

Show detected agent and skill paths for current directory

    $ skillsdir detect

    Agent Detection
    ────────────────────────────────────────
      Detected agent:  GitHub Copilot (copilot)
      Project path:    /path/to/your/project

    Installation Paths
    ────────────────────────────────────────
      Project paths (--project):
        ✓ .github/skills
          .claude/skills

      Personal path (--global):
          ~/.copilot/skills

      Instructions file:
        ✓ .github/copilot-instructions.md

#### `skillsdir list`

Manage

List all installed skills grouped by location

    $ skillsdir list

    Installed skills (3):

      [global]
        anthropic/pdf@1.0.0
        Process and analyze PDF documents

      [project (copilot)]
        github/web-design-reviewer@0.0.0
        Visual inspection of websites

      [project (claude)]
        vercel/nextjs-app-router@1.2.0
        Next.js App Router development

    # Output as JSON
    $ skillsdir list --json

#### `skillsdir init`

Publish

Create a new `skill.json` manifest interactively

    $ skillsdir init

    Creating skill.json

    skill name (my-skill): web-scraper
    version (1.0.0):
    description: Scrape and extract data from websites
    author: Your Name
    license (MIT):
    runtime (universal): mcp
    keywords (comma-separated): web, scraping, extraction

    ✓ Created skill.json
    ✓ Created SKILL.md

#### `skillsdir uninstall <skill-id>`

Manage

Remove an installed skill

    $ skillsdir uninstall anthropic/pdf
    Remove anthropic/pdf from ~/.skills/installed/anthropic/pdf? [y/N] y
    ✓ Uninstalled anthropic/pdf

#### `skillsdir update`

Manage

Check for and apply updates to installed skills

    $ skillsdir update

    Updates available:
      anthropic/pdf
      vercel/nextjs-app-router

    Update 2 skill(s)? [y/N] y
    ✓ Updated anthropic/pdf
    ✓ Updated vercel/nextjs-app-router

#### `skillsdir config`

Manage

View or modify CLI configuration

    $ skillsdir config list
    {
      "registry": "https://cdn.jsdelivr.net/.../catalog.json",
      "cache_ttl": 3600,
      "auto_update": true
    }

    $ skillsdir config set cache_ttl 7200
    ✓ Set cache_ttl = 7200

### 📤 Publishing Commands

#### `skillsdir login`

Publish

Authenticate with GitHub for publishing skills

    $ skillsdir login

    GitHub Authentication
    ────────────────────────────────────────
    → Opening browser to generate a personal access token...
      URL: https://github.com/settings/tokens/new?...

    Paste your token: ghp_xxxxxxxxxxxx
    ✓ Authenticated as: your-username
    ✓ Token saved to ~/.skills/config.json

#### `skillsdir validate`

Publish

Validate a skill directory before publishing

    $ skillsdir validate ./my-skill

    Validating Skill
    ────────────────────────────────────────
      Directory: /path/to/my-skill
    → Fetching catalog for duplicate check...

    ✅ Valid

    Checks passed:
      ✓ skill.json schema valid
      ✓ SKILL.md has content
      ✓ No secrets detected
      ✓ No malicious patterns
      ✓ No duplicate name

#### `skillsdir publish`

Publish

Publish a skill to GitHub and optionally submit to the directory

    $ skillsdir publish

    Publishing Skill
    ────────────────────────────────────────
    → Running validation checks...
    ✓ Valid skill: web-scraper@1.0.0
    ✓ Authenticated as: your-username
    → Skill ID: your-username/web-scraper
    → Pushing to GitHub...
    ✓ Created release: v1.0.0

    ✓ Published your-username/web-scraper@1.0.0

      To add to the official directory:
        skillsdir publish --submit

    # Submit to official directory
    $ skillsdir publish --submit
    → Creating submission issue...
    ✓ Submission created!
      https://github.com/dmgrok/agent_skills_directory/issues/123

    # Preview without changes
    $ skillsdir publish --dry-run

## 🎯 What are Agent Skills?

Agent Skills are modular, reusable instruction packages that extend AI coding agents with specialized capabilities. Unlike monolithic instruction files, skills are composable, version-controlled, and automatically matched to your project context.

### ❌ Traditional Approach

- `CLAUDE.md` - Single file, grows unwieldy
- `.github/copilot-instructions.md` - Agent-specific
- `.cursorrules` - Vendor lock-in
- `AGENTS.md` - Manual maintenance

🔴 One giant file per project 🔴 No reusability across projects 🔴 Manual updates required 🔴 Agent-specific formats

### ✅ Agent Skills Approach

- `SKILL.md` - Focused, single-purpose
- Works with Claude, Copilot, Codex
- Auto-matched to tech stack
- Community-maintained registry

🟢 Modular & composable 🟢 Share across projects 🟢 Auto-updates from registry 🟢 Agent-agnostic standard

### 📁 Skill Structure

    my-skill/
    ├── SKILL.md        # Instructions + metadata (required)
    ├── scripts/        # Executable automation (optional)
    ├── references/     # Documentation files (optional)
    └── assets/         # Templates, schemas (optional)

### 🛠️ How to Build a Good Skill

- Start with a clear goal and a single responsibility per skill.
- Keep instructions concise; prefer step lists over prose.
- Include context guards (prereqs, tech stack) to avoid misuse.
- Scope to file types using globs (e.g., `*.tsx`, `**/*.test.ts`) so the skill only applies where relevant.
- Document inputs/outputs and expected files touched.
- Add short examples or test commands that validate success.
- Reference trusted sources (docs, standards) when relevant.
- Check for safety: no secrets, destructive commands, or ambiguous actions.
- Use tags and category from the catalog schema for easy discovery.

📖 See the Agent Skills specification for full guidelines.

### 🎯 Scoping Skills to File Types

Skills can be limited to specific files, paths, or contexts using the `globs` field or context guards:

Method | Example | Use Case
--- | --- | ---
`globs` (frontmatter) | `["*.tsx", "*.jsx"]` | Only apply to React component files
`globs` (path patterns) | `["src/components/**/*"]` | Only apply within specific directories
`globs` (test files) | `["**/*.test.ts", "**/*.spec.ts"]` | Only apply to test files
Context guards (markdown) | "Skip when editing config files" | Soft guidance for the agent

### 📝 Sample SKILL.md Template

    ---
    name: my-awesome-skill
    description: Brief description of what this skill does
    category: development
    tags: [typescript, testing, react]
    globs: ["*.tsx", "*.jsx", "src/components/**/*"]
    version: 1.0.0
    ---

    # My Awesome Skill

    ## Context
    - **Applies to:** `*.tsx`, `*.jsx` files in React projects
    - **Skip when:** Editing config files, markdown, or non-component code
    - **Requires:** Node.js 18+, React 18+

    ## Instructions

    1. **Step One** — Clear action the agent should take
    2. **Step Two** — Next action with expected outcome
    3. **Step Three** — Final step or validation

    ## Examples

    ```bash
    # Command to verify the skill worked
    npm test
    ```

    ## References
    - [Official Docs](https://example.com/docs)

## 🚀 How to Use Skills

Choose the method that works best for your workflow

### 🤖 Mother Skills MCP Server Recommended

Auto-detects your tech stack and installs matching skills automatically.

1

#### Configure MCP Server

Add to `.vscode/mcp.json` (Copilot) or `.mcp.json` (Claude):

    {
      "mcpServers": {
        "mother-skills": {
          "command": "node",
          "args": ["/path/to/mcp-mother-skills/dist/index.js"],
          "env": { "MOTHER_PROJECT_PATH": "." }
        }
      }
    }

2

#### Sync Skills

In your AI agent conversation:

    sync_skills

Mother detects React, TypeScript, Docker, etc. and installs relevant skills.

3

#### Install Specific Skills or Bundles

    install_skill("pdf")
    install_bundle("web-development")

📦 Get Mother Skills MCP

### ⚡ Skills CLI Tool

npm-like package manager for skills. Search, install, and manage skills from your terminal.

1

#### Install the CLI

    # Homebrew (macOS/Linux)
    brew install dmgrok/tap/skills

    # Or quick install script
    curl -fsSL https://raw.githubusercontent.com/dmgrok/agent_skills_directory/main/install.sh | sh

See the CLI tab above for all installation options.

2

#### Search & Install Skills

    # Search for skills
    skillsdir search "pdf"

    # Install globally
    skillsdir install anthropic/pdf

    # Install to project (auto-detects agent)
    skillsdir install anthropic/pdf --project

3

#### Manage Installed Skills

    # List installed skills
    skillsdir list

    # Update skills
    skillsdir update

    # Detect project agent
    skillsdir detect

💡 Tip: Check the CLI tab above for the complete command reference and all features.

### 📥 Manual Download from Website

Browse and download skills directly from this website—no tools required.

1

#### Browse Skills

Go to the Browse Skills tab above and find a skill you want.

2

#### Get the Skill Link

Click on a skill card to view details. The modal shows the source repository link.

Visit the skill's GitHub repo and download the `SKILL.md` file (and any `scripts/`, `references/`, or `assets/` folders).

3

#### Add to Your Project

Create a skills directory and add the downloaded files:

    # For GitHub Copilot
    .github/skills/skill-name/SKILL.md

    # For Claude
    .claude/skills/skill-name/SKILL.md

    # For Cursor
    .cursor/skills/skill-name/SKILL.md

4

#### Reference in Instructions (Optional)

Some agents auto-discover skills. For others, add to your instructions file:

    ## Available Skills
    Check .github/skills/ for reusable agent instructions.

### 📚 Reference Documentation

Additional details about agents, file structure, and manifest format

Skills are installed to different directories based on the detected agent:

Agent | Project Path | Personal Path | Instructions File
--- | --- | --- | ---
Claude | `.claude/skills/` | `~/.claude/skills/` | `CLAUDE.md`
Copilot | `.github/skills/` | `~/.copilot/skills/` | `.github/copilot-instructions.md`
Codex | `.codex/skills/` | `~/.codex/skills/` | `AGENTS.md`
Cursor | `.cursor/skills/` | `~/.cursor/skills/` | `.cursorrules`

    # Global skills (shared across projects)
    ~/.skills/
    ├── config.json          # CLI configuration
    ├── installed/           # Global skills
    │   └── anthropic/pdf/
    └── cache/               # Catalog cache

    # Project skills (per-agent)
    your-project/
    ├── .claude/skills/      # Claude skills
    │   └── pdf/
    ├── .github/skills/      # Copilot skills
    │   └── web-design-reviewer/
    ├── .codex/skills/       # Codex skills
    └── .cursor/skills/      # Cursor skills

Define your skill's metadata, dependencies, and capabilities:

    {
      "name": "my-skill",
      "version": "1.0.0",
      "description": "A skill that does amazing things",
      "author": "Your Name",
      "license": "MIT",
      "runtime": "mcp",
      "keywords": ["automation", "productivity"],
      "entry": "SKILL.md",
      "dependencies": {
        "anthropic/browser-use": "^1.0.0"
      },
      "capabilities": ["web-browsing", "file-system"],
      "inputs": [
        { "name": "url", "type": "string", "required": true }
      ],
      "outputs": [
        { "name": "result", "type": "object" }
      ]
    }

📖 See the full skill manifest schema.

### 🔗 Registry Endpoints

All formats point to the latest catalog on `main`:

- `catalog.json` (pretty): cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.json
- `catalog.min.json` (minified): cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.min.json
- `bundles.json` (skill bundles): cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/bundles.json
- `exports/claude-skills.json`: cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/claude-skills.json
- `exports/copilot-skills.json`: cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/copilot-skills.json
- `exports/mcp-compatible.json`: cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/mcp-compatible.json
- `exports/premium-skills.json`: cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/premium-skills.json
- `exports/active-skills.json`: cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/exports/active-skills.json

Pin a specific release with `@vYYYY.MM.DD` instead of `@main`.

### 🎛️ Filtering via URL

Share filtered views by adding query params to the docs URL:

    ?provider=anthropics
    ?provider=vercel
    ?category=development
    ?search=notion       # or ?q=...
    ?tags=git,api        # comma-separated
    ?id=anthropics/pdf   # open modal directly

Combine params as needed, e.g. `?provider=openai&category=documents&search=pdf` or `?provider=vercel`.