# mdskills.ai

> The community marketplace for AI agent skills, MCP servers, rules, plugins, and tools. Browse 1500+ skills for Claude Code, Cursor, Codex, and 27+ AI coding agents.

## Docs
- [What are Skills](https://www.mdskills.ai/docs/what-are-skills): The SKILL.md format and how AI agents consume skills
- [Create a Skill](https://www.mdskills.ai/docs/create-a-skill): Step-by-step guide to authoring your first skill
- [Best Practices](https://www.mdskills.ai/docs/skill-best-practices): Writing effective, well-structured agent skills
- [Skills vs MCP](https://www.mdskills.ai/docs/skills-vs-mcp): When to use skills vs MCP servers
- [Install Skills](https://www.mdskills.ai/docs/install-skills): How to install skills in Claude Code, Cursor, and other clients
- [Skill Examples](https://www.mdskills.ai/docs/skill-examples): Annotated real-world skill examples

## Specifications
- [SKILL.md](https://www.mdskills.ai/specs/skill-md): The agent skills format — structured markdown that teaches AI agents specific capabilities
- [AGENTS.md](https://www.mdskills.ai/specs/agents-md): Project-level AI agent instructions and context
- [MCP Protocol](https://www.mdskills.ai/specs/mcp): Model Context Protocol for tool integration
- [CLAUDE.md](https://www.mdskills.ai/specs/claude-md): Claude Code project instructions format
- [.cursorrules](https://www.mdskills.ai/specs/cursorrules): Cursor editor custom rules format
- [SOUL.md](https://www.mdskills.ai/specs/soul-md): AI personality and behavior definition format
- [llms.txt](https://www.mdskills.ai/specs/llms-txt): Making websites AI-readable (this format)

## Marketplace
- [Skills](https://www.mdskills.ai/skills): Agent skills (SKILL.md, AGENTS.md, CLAUDE.md)
- [MCP Servers](https://www.mdskills.ai/mcp-servers): Model Context Protocol servers
- [Rules](https://www.mdskills.ai/rules): Editor rules (.cursorrules, .windsurfrules)
- [Plugins](https://www.mdskills.ai/plugins): Claude Code plugins
- [Tools](https://www.mdskills.ai/tools): Standalone developer tools
- [Tags](https://www.mdskills.ai/tags): Skills grouped by tag (integration, language, tool)

## API
- [GET /api/skills](https://www.mdskills.ai/api/skills): Search and browse skills (JSON). Params: q, category, artifact_type (skill_pack|mcp_server|ruleset|plugin|tool), sort (popular|recent|trending), limit (max 50)
- [GET /api/skills/{slug}](https://www.mdskills.ai/api/skills/example-slug): Full skill detail with content, README, permissions, and install instructions
- [GET /api/categories](https://www.mdskills.ai/api/categories): List all categories with slug, name, description

## Reference (markdown-source pages)
- [/ref](https://www.mdskills.ai/ref): Full index of every reference page — start here
- [Quickstart](https://www.mdskills.ai/ref/quickstart): Install a skill in one command
- [What is a skill.md file](https://www.mdskills.ai/ref/what-is-a-skill-md-file): Format and anatomy
- [Skills vs MCP servers](https://www.mdskills.ai/ref/skills-vs-mcp): When to use which
- [Skills vs subagents](https://www.mdskills.ai/ref/skills-vs-subagents): When to use which
- [Artifact types](https://www.mdskills.ai/ref/artifact-types): The 12 categories in the catalog
- [Install locations by agent](https://www.mdskills.ai/ref/install-locations-by-agent): Where each AI agent expects files
- [API usage](https://www.mdskills.ai/ref/api-usage): Public read-only JSON API
- [Submit a skill](https://www.mdskills.ai/ref/submit-a-skill): How to list on mdskills.ai
- [Sponsor mdskills](https://www.mdskills.ai/ref/sponsor-mdskills): $79/mo run-of-site sponsorship
- [Frequently asked questions](https://www.mdskills.ai/ref/frequently-asked-questions): Common questions

## Optional
- [llms-full.txt](https://www.mdskills.ai/llms-full.txt): Every /ref/* page inlined plus catalog contents by category. Single fetch, ~200KB.