{"id":51551711,"url":"https://github.com/strapi/skills","last_synced_at":"2026-07-10T00:30:55.034Z","repository":{"id":366550600,"uuid":"1249466876","full_name":"strapi/skills","owner":"strapi","description":"AI Agent Skills A collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities.","archived":false,"fork":false,"pushed_at":"2026-06-29T16:59:23.000Z","size":179,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-29T18:26:12.504Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/strapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-25T18:23:47.000Z","updated_at":"2026-06-24T15:03:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/strapi/skills","commit_stats":null,"previous_names":["strapi/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/strapi/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strapi%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strapi%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strapi%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strapi%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/strapi","download_url":"https://codeload.github.com/strapi/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strapi%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35316840,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-10T00:30:54.867Z","updated_at":"2026-07-10T00:30:55.009Z","avatar_url":"https://github.com/strapi.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Strapi Skills\n\nA collection of **public agent skills** that help you build Strapi applications with AI coding assistants (Cursor, Claude Code, Codex, and more).\n\nSkills are reusable `SKILL.md` instruction files that coding agents load for domain-specific tasks. The skills in this repo encode Strapi 5 conventions and workflows so assistants follow official Strapi patterns and best practices.\n\nThese skills are distributed through the [open agent skills ecosystem](https://www.skills.sh) and installed with the [`skills` CLI](https://github.com/vercel-labs/skills) (`npx skills`).\n\n## Available skills\n\n| Skill | Description |\n| ----- | ----------- |\n| [`strapi-docs-mcp`](./skills/cms/strapi-docs-mcp) | Query the official Strapi documentation through the `strapi-docs` MCP server (powered by Kapa). Use for any Strapi question — API syntax, configuration, features, plugins, upgrades, CLI. |\n| [`strapi-mcp-capabilities`](./skills/cms/strapi-mcp-capabilities) | Create custom MCP capabilities (tools, prompts, resources) in a Strapi 5 plugin via the `strapi.ai.mcp` service. |\n\nMore skills will be added over time. Browse the [`skills/`](./skills) directory for the full list.\n\n## What are agent skills?\n\nAgent skills are reusable instruction sets that extend a coding agent's capabilities. Each skill is a directory containing a `SKILL.md` file with YAML frontmatter (`name` + `description`) and a Markdown body of instructions the agent follows when the skill is activated.\n\n## Requirements\n\n- [Node.js](https://nodejs.org) (to run `npx skills`)\n- A supported coding agent (Cursor, Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot, Windsurf, Cline, etc.). The CLI auto-detects installed agents; if none are detected, you'll be prompted to pick one.\n\n## Install the Strapi skills\n\nThe `skills` CLI resolves sources from GitHub shorthand, full URLs, direct paths, GitLab URLs, any git URL, or local paths.\n\n```bash\n# Install all Strapi skills (interactive)\nnpx skills add strapi/skills\n\n# List the skills available in this repo without installing\nnpx skills add strapi/skills --list\n\n# Install a specific skill\nnpx skills add strapi/skills --skill strapi-docs-mcp\n\n# Install a single skill by direct path\nnpx skills add https://github.com/strapi/skills/tree/main/skills/cms/strapi-docs-mcp\n```\n\n### Choose where skills are installed\n\n| Scope | Flag | Location | Use case |\n| ----- | ---- | -------- | -------- |\n| **Project** | _(default)_ | `./\u003cagent\u003e/skills/` | Committed with your Strapi project, shared with the team |\n| **Global** | `-g` | `~/\u003cagent\u003e/skills/` | Available across all your projects |\n\n```bash\n# Project-scoped (recommended for Strapi apps — committed so the whole team shares it)\nnpx skills add strapi/skills --skill strapi-docs-mcp -a cursor -y\n\n# Global (personal, available in every project)\nnpx skills add strapi/skills --skill strapi-docs-mcp -g -a cursor -y\n```\n\n## Setting up skills inside a Strapi app\n\nThe recommended setup for a Strapi project is **project-scoped** installation: skills land in `./\u003cagent\u003e/skills/` and are committed, so everyone on the team gets the same Strapi guidance.\n\nFrom the root of your Strapi app:\n\n```bash\n# 1. Install the docs skill for your agent (example: Cursor)\nnpx skills add strapi/skills --skill strapi-docs-mcp -a cursor -y\n\n# 2. Commit the installed skill so the team shares it\ngit add .agents/skills/strapi-docs-mcp\ngit commit -m \"chore: add strapi-docs-mcp agent skill\"\n```\n\nThen restart/reload your agent so it picks up the new skill. In Cursor, skills in `.agents/skills/` are loaded automatically on the next session.\n\n### Recommended skills for a Strapi app\n\n- **Always:** `strapi-docs-mcp` — keeps the agent grounded in the official, up-to-date docs instead of its training data.\n- **When building a plugin that extends the Strapi MCP server:** `strapi-mcp-capabilities` — guides the `strapi.ai.mcp` registration patterns, lifecycle rules, and Zod schemas.\n\n```bash\nnpx skills add strapi/skills \\\n  --skill strapi-docs-mcp \\\n  --skill strapi-mcp-capabilities \\\n  -a cursor -y\n```\n\n### Pair skills with the Strapi MCP server\n\nFor the best results, also connect your agent to a Strapi MCP server so it can act on a live Strapi instance, not just answer doc questions:\n\n- **Docs server** (read-only Strapi documentation): `https://strapi-docs.mcp.kapa.ai` — OAuth flow on first connection. See [connection details](https://docs.strapi.io/cms/ai/docs-mcp-server#connection-details).\n- **Instance server** (read/write your running Strapi): enable `config/server.ts` → `mcp: { enabled: true }`, then connect to `POST http://localhost:1337/mcp` with `Authorization: Bearer \u003cadmin-token\u003e`. Requires Strapi 5.47.0+. See the [Strapi MCP server docs](https://docs.strapi.io/cms/features/strapi-mcp-server).\n\nThe `strapi-docs-mcp` skill knows how to detect the docs server, use it if present, and fall back to the `llms.txt` / per-page Markdown sources if it isn't.\n\n```bash\n# List installed skills (project + global)\nnpx skills list\n\n# List only global skills\nnpx skills ls -g\n\n# Search the ecosystem for Strapi-related skills\nnpx skills find strapi\n\n# Update installed skills to their latest version\nnpx skills update\n\n# Update a specific skill\nnpx skills update strapi-docs-mcp\n\n# Remove a skill\nnpx skills remove strapi-docs-mcp\n\n# Create a new SKILL.md template (for authoring your own)\nnpx skills init my-skill\n```\n\n## Creating your own Strapi skill\n\nA skill is a directory with a `SKILL.md` containing YAML frontmatter:\n\n```markdown\n---\nname: my-strapi-skill\ndescription: What this skill does and when to use it. The agent reads this to decide when to activate it.\n---\n\n# My Strapi Skill\n\nInstructions for the agent to follow when this skill is activated.\n\n## When to use\n\nDescribe the scenarios where this skill should be used.\n\n## Steps\n\n1. First, do this\n2. Then, do that\n```\n\nRequired frontmatter: `name` (lowercase, hyphens allowed) and `description`. Optional: `metadata.internal: true` to hide a work-in-progress skill from normal discovery (install with `INSTALL_INTERNAL_SKILLS=1`).\n\nScaffold a new skill in your Strapi plugin repo:\n\n```bash\nnpx skills init my-strapi-skill\n```\n\nThen commit it under `skills/\u003cname\u003e/SKILL.md` and install it locally to test:\n\n```bash\nnpx skills add ./path/to/my-strapi-skill -a cursor -y\n```\n\n## Troubleshooting\n\n- **\"No skills found\"** — ensure the repo contains valid `SKILL.md` files with both `name` and `description` in the frontmatter. Run `npx skills add strapi/skills --list` to verify discovery.\n- **Skill not loading in agent** — confirm the skill was installed to the correct path for your agent (see the table above), restart/reload the agent, and verify the `SKILL.md` frontmatter is valid YAML.\n- **Permission errors** — ensure write access to the target directory (`./\u003cagent\u003e/skills/` or `~/\u003cagent\u003e/skills/`).\n- **Symlinks unsupported** — reinstall with `--copy`.\n\n## Links\n\n- [Strapi documentation](https://docs.strapi.io)\n- [Strapi on GitHub](https://github.com/strapi/strapi)\n- [Skills CLI (vercel-labs/skills)](https://github.com/vercel-labs/skills)\n- [Skills directory (skills.sh)](https://www.skills.sh)\n- [Skills docs](https://www.skills.sh/docs)\n- [Strapi docs MCP server](https://docs.strapi.io/cms/ai/docs-mcp-server)\n- [Strapi MCP server](https://docs.strapi.io/cms/features/strapi-mcp-server)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrapi%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstrapi%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrapi%2Fskills/lists"}