| name | ask-docs |
| description | 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. |
Ask CrewAI Docs
Answer CrewAI questions by looking up the official documentation at docs.crewai.com.
When to Use This Skill
Use this skill when:
- The user asks about a CrewAI feature, parameter, or behavior not covered in detail by the other skills
- You need to verify current API syntax, method signatures, or configuration options
- The user hits an error and needs troubleshooting guidance from official docs
- The question is about a newer or less common CrewAI feature (e.g., telemetry, testing, CLI commands, deployment, enterprise features)
- The question is about experimental conversational Flows and you need the current
handle_turn(), ConversationConfig, RouterConfig, tracing, or streaming behavior
- You're unsure whether your knowledge is current — the docs reflect the latest published state
Do NOT use this skill when the question is clearly answered by one of the other skills (getting-started, design-agent, design-task). Those skills contain curated, opinionated guidance. This skill is for filling gaps and verifying details.
How to Query the Docs
Step 1: Fetch the docs index
The CrewAI docs site publishes an llms.txt file — a structured index of every documentation page with descriptions. Fetch it first to find the right page:
WebFetch: https://docs.crewai.com/llms.txt
This returns a categorized list of all doc pages in the format:
- [Page Title](https://docs.crewai.com/path/to/page): "Description of what the page covers"
Categories include:
- API Reference — REST endpoints (kickoff, status, resume, inputs)
- Concepts — agents, crews, tasks, tools, flows, memory, knowledge, LLMs, processes, training, testing
- Enterprise — RBAC, SSO, automations, traces, deployment, triggers, integrations
- Tools Library — 40+ tools organized by category (AI/ML, automation, cloud, database, files, search, web scraping)
- MCP Integration — MCP server setup, transports, DSL, security
- Examples & Cookbooks — practical implementations
- Learning Paths — tutorials and advanced topics
- Observability — monitoring integrations
For conversational Flow questions, go directly to:
WebFetch: https://docs.crewai.com/en/guides/flows/conversational-flows
Treat this page as the source of truth for the experimental crewai.experimental.conversational surface. Verify it before answering detailed API questions because the feature may change before it graduates.
Step 2: Fetch the relevant page
Once you identify the right page from the index, fetch its content:
WebFetch: https://docs.crewai.com/<path-from-index>
Step 3: Synthesize and cite
Combine what you find from the docs with context from the other skills to give a clear, actionable response. Always include the docs URL so the user can read further.
Workflow Summary
- Understand the user's question — what specific CrewAI concept, API, or behavior are they asking about?
- Fetch
llms.txt — scan the index to find the most relevant page(s)
- Fetch the page(s) — retrieve the actual documentation content
- Synthesize the answer — combine docs content with context from other skills
- Cite the source — include the docs URL in your response
For an Even Better Experience
Users who frequently query CrewAI docs can configure the CrewAI docs MCP server in their coding agent for richer, structured search:
https://docs.crewai.com/mcp
This is optional — the llms.txt workflow above works without any setup.
Examples of Good Use Cases
| User Question | Why This Skill |
|---|
"What parameters does Crew() accept?" | Specific API reference — docs are authoritative |
| "How do I set up telemetry in CrewAI?" | Niche feature not covered in other skills |
"What's the difference between Process.sequential and Process.hierarchical?" | Detailed comparison best sourced from docs |
"I'm getting ValidationError when using output_pydantic" | Troubleshooting — docs may have known issues or caveats |
| "How do I deploy a CrewAI flow to production?" | Deployment guidance lives in docs, not in design skills |
"What CLI commands does crewai support?" | CLI reference is a docs concern |
| "How do I configure memory for a crew?" | Detailed config options beyond what design-agent covers |
| "What tools are available for web scraping?" | Tools library reference |
| "How do I set up SSO for CrewAI enterprise?" | Enterprise features live in docs |
| "How do I build a chat app with Flow.handle_turn()?" | Experimental conversational Flow API; verify the latest guide |
Related Skills
- getting-started — project scaffolding, choosing abstractions, Flow architecture
- design-agent — agent Role-Goal-Backstory, parameter tuning, tools, memory & knowledge
- design-task — task descriptions, expected_output, guardrails, structured output, dependencies
