Skill Recommender
Analyzes user intent and project context to suggest the most appropriate documentation skills from the AI Dev Flow framework catalog.
The source repository doesn't declare a license. Check its terms before reusing the code.
Key features
- Automated mapping of user requests to a 25+ core documentation skill catalog
- Context-aware analysis of project structure and existing artifacts
- Ambiguity detection with automated clarification questions for better accuracy
- Natural language intent parsing for actions like create, update, and validate
- Ranked recommendation engine with confidence scores and logic rationale
Use cases
- Identifying the correct skill to use when starting a new documentation workflow
- Discovering available framework capabilities for specific documentation intents
- Navigating complex documentation catalogs without deep technical knowledge of the framework
FAQ
What does the Skill Recommender do?
The Skill Recommender acts as an intelligent navigation layer for the AI Dev Flow framework. It parses your natural language intent (like 'write a plan' or 'check links') and matches it against a catalog of 25+ specialized documentation skills to suggest the most appropriate tool for your specific task.
Which documentation artifacts does it support?
The Skill Recommender covers the entire AI Dev Flow lifecycle, mapping requests to Business Requirements (BRD), Product Requirements (PRD), Architecture Decision Records (ADR), BDD test scenarios, System Requirements (SYS), and traceability validation tools like trace-check.
What happens if my request is ambiguous?
If your request is unclear—such as 'help me document the architecture'—the skill triggers ambiguity detection. It will provide a ranked list of potential matches (like ADRs or System Specs) and ask automated clarification questions to ensure you select the correct tool for your needs.
When should I use this skill?
Use this skill whenever you are unsure which documentation command to run, when you're starting a new project phase, or when you want to discover available capabilities within the framework. It is particularly helpful for users who haven't yet memorized the full SDD (Software Design Document) workflow.
How does it improve my AI coding workflow?
It eliminates guesswork and reduces cognitive load by providing ranked recommendations with confidence scores and logic rationales. Instead of hunting through documentation, you get an immediate suggestion on the best next step, ensuring higher accuracy and compliance with framework standards.
Related skills
Claude Docs Consultant
Retrieves real-time, official Claude Code documentation via selective fetching to ensure accurate implementation of hooks, skills, and subagents.
Learning Documentation1,44712 ptsClaude Code Skills
Facilitates the creation and optimization of specialized capabilities for Claude Code through standardized architecture and development workflows.
Learning Documentation212 ptsUpdate Component Reference
Automates the documentation process for Claude Code components by generating standardized MDX files for commands, agents, skills, hooks, and MCP servers.
Learning Documentation4012 pts