ask-docs skill (crewAIInc): answer CrewAI questions from the live docs

crewAI's own skill that makes a coding agent answer CrewAI questions from the official docs for the version you run.

Installs: 8.4K; on skills.sh
Stars: 48; on GitHub
Updated: Oct 2026; last repo commit

ask-docs makes your coding agent look up CrewAI answers in the official docs instead of guessing. It first checks which crewai version you run, then reads the docs for that release through the docs MCP server or through llms.txt and Markdown pages.

It loads when a CrewAI question is not covered by the other CrewAI skills, or when another skill asks to re-check a version-sensitive fact. Reading the docs needs web access. The docs MCP server is optional.

Good for

Python developers building agents or crews with the CrewAI framework
Developers who want answers tied to their installed crewai version
People working with the AMP platform docs, the REST API or conversational Flows

Install ask-docs

Claude Code

Copy this prompt.

Install the ask-docs skill in Claude Code. Run this command:

/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both, or you get every skill twice. The README documents the plugin route for Claude Code. The plugin installs all 10 skills in the crewai-skills plugin. ask-docs works on its own; the other nine CrewAI skills are optional hand-offs it names.

From the project README. Source.

What's in the skill

When it loads

Query the official CrewAI documentation for answers. Use when the user has a CrewAI question that isn't fully covered by the getting-started, design-agent, design-task skills — e.g., specific API details, configuration options, advanced features, troubleshooting errors, enterprise features, tool references, or anything where the latest docs are the best source of truth.

Sections in SKILL.md

When to Use This Skill
How to Query the Docs
Path A: the docs MCP server (if configured)
Path B: llms.txt and Markdown pages (no setup)
Path C: GitHub source of the docs
Match the docs to the user's version
Check docs snippets against the installed package
Workflow Summary
Worked examples (checked 2026-10-01 against crewai 1.15.23)
Setting Up the Docs MCP Server (optional)
Related Skills

Key facts

Author: crewAI (the crewAIInc organisation); the plugin manifest names crewAI as author and the repo is the vendor's own
License: MIT (LICENSE file and README agree)
Installs on skills.sh: 8,402 as of 2026-11-02
GitHub stars: 48 for the whole crewAIInc/skills repo, 2026-11-02
What is inside: 1 file: SKILL.md. The repo has a second copy at .agents/skills/ask-docs/SKILL.md. It bundles no scripts.
Last change to this skill: 2026-10-06
Part of: The crewai-skills plugin (10 skills) in the crewai-plugins marketplace
Checked against: crewai 1.15.23 on 2026-10-01, per the SKILL.md

What it includes

Search the docs with search_crew_ai and a version
The docs.crewai.com/mcp server needs no authentication. SKILL.md lists search_crew_ai, query_docs_filesystem_crew_ai (a read-only shell over a virtual docs tree) and submit_feedback, which it says not to call unless you ask.
Try: “Where in the CrewAI docs is the planning parameter on Crew?”
Network · Path A: docs MCP server
Fetch the docs index, then the page as Markdown
Needs no setup. The agent fetches docs.crewai.com/llms.txt, then the page with a .md suffix. For AMP platform questions it uses docs-platform.crewai.com.
Network · Path B: llms.txt and .md pages
Read the docs files from the crewAI repo
A fallback when the docs site is unreachable. The docs live under docs/<version>/<lang>/ in crewAIInc/crewAI.
Network · Path C: GitHub docs source
Run crewai version, then read that release's docs
Releases from 1.10.0 onward are hosted, plus edge. If yours is not hosted, the agent reads the nearest one and says so.
Runs code · Match docs to your version
Compare docs code with the installed signature
Suggests python -c with inspect.signature, and running the smallest snippet that needs no API key.
Runs code · Check snippets against the package
Add the docs server to Claude Code, Codex CLI or Cursor
SKILL.md gives claude mcp add, codex mcp add, and a Cursor mcp.json entry. The project scope writes .mcp.json in your repo.
Write · Optional docs MCP setup

From the official docs

Permissions

Low risk

The agent fetches pages from the CrewAI docs sites and can run version checks on your machine. The optional MCP setup writes a server entry into your agent config.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Optional MCP setup changes your agent config
The setup commands add the crewai-docs server to your Claude Code, Codex or Cursor config. Skip it if you do not want a new server entry. github.com
It can download a 2 MB docs file
For hard questions SKILL.md says to download llms-full.txt, about 2 MB, and search it instead of loading it into context. github.com
The docs MCP server has a feedback tool
SKILL.md lists submit_feedback, which reports a docs problem to the docs team, and says not to call it unless you ask. github.com
The plugin route installs all 10 skills
The crewai-skills plugin manifest lists 10 skills and holds no hooks, agents or MCP config in the git tree. Use the skills CLI route if you want only the skills this page names. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Talks to	docs.crewai.com. docs-platform.crewai.com. raw.githubusercontent.com (crewAIInc/crewAI docs, fallback)
Sign-in and keys	SKILL.md says the docs MCP server needs no authentication.
Scopes	Reads docs.crewai.com and docs-platform.crewai.com pages Runs crewai version or a Python version check in your project Optional setup writes .mcp.json, ~/.codex/config.toml or Cursor mcp.json

Questions

What does the ask-docs skill do?

It makes your coding agent answer CrewAI questions from the official docs, for the version you have installed. It covers both the open-source docs and the CrewAI AMP platform docs.

How do I install ask-docs?

Use the install box at the top of this page. The README documents a Claude Code plugin with all 10 CrewAI skills. The box also lists the optional docs MCP server command.

Does ask-docs need the docs MCP server?

No. SKILL.md says the llms.txt route works with no setup, and the MCP server is optional for structured search. The MCP server at docs.crewai.com/mcp needs no authentication.

Does it need an API key?

SKILL.md says the docs MCP server needs no authentication and lists no key for the other routes.

Is ask-docs safe?

It reads public docs pages and can run a version check in your project. The optional MCP setup writes a server entry to your agent config, so run it only if you want that.

Is this the official CrewAI skill?

Yes, it is in the crewAIInc organisation's own repo, and the plugin manifest names crewAI as author.

What is the CrewAI docs MCP server URL?

https://docs.crewai.com/mcp for the open-source docs, and https://docs-platform.crewai.com/mcp for the AMP platform docs, per SKILL.md.

Does it work in the Claude app or Codex?

The README documents Claude Code only. The skill can run local checks and edit agent config, so there is no Claude app upload option here. The box lists the Codex skills folder and the Codex MCP command from SKILL.md.

Information

updated Nov 2, 2026

Repository: crewaiinc/skills
Folder: skills/ask-docs

crewaiinc/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

README.md · github.com
marketplace.json · github.com
plugin.json · github.com
SKILL.md · github.com