functional-planner — Claude Code skill: what it does, how to install
functional-planner turns product requirement documents into validated work-item hierarchies for Azure DevOps, GitHub, or Jira.
no license ★ 1,627 updated 2026-10-25
npx skills add microsoft/hve-core --skill functional-planner -a claude-codeWhat functional-planner does
The skill inspects PRDs and translates them into epics, features, user stories, or tasks. Before finalizing the structure, it inspects your issue tracker in read-only mode to verify allowed issue types and fields. You can shape the decomposition through one of three lenses: generic, scrum, or kanban.
All planning strictly respects a read-only boundary. The skill never writes, comments on, transitions, or creates issues in your remote repository. Instead, it generates local tracking files like handoff.md and planning-log.md for review.
Targeting Jira requires JIRA_BASE_URL alongside JIRA_API_TOKEN or JIRA_PAT. If tracker credentials or the PRD file cannot be resolved, execution halts immediately.
What it helps with
- convert PRD files into structured work-item hierarchies
- validate tracker issue types before attempting batch creation
- shape task decomposition through Scrum or Kanban lenses
- produce a reviewable handoff file for backlog execution
Example prompts for the agent
- Decompose docs/prd.md for Jira using the scrum lens
- Plan a work item hierarchy for GitHub issues from the open specification
- Generate an Azure DevOps handoff.md from specs/billing.md
How to install functional-planner
1Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill functional-planner -a claude-code2Manually: put the files in place
~/.claude/skills/functional-planner/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/functional-planner/
1Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill functional-planner -a codex2Manually: put the files in place
.agents/skills/functional-planner/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill functional-planner -a cursor2Manually: put the files in place
.cursor/skills/functional-planner/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install microsoft/hve-core .github/skills/project-planning/functional-planner2Manually: put the files in place
.github/skills/functional-planner/SKILL.md1Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill functional-planner -a gemini-cli2Platform CLI
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/project-planning/functional-plannerManually: put the files in place
.devin/skills/functional-planner/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about functional-planner
How to install functional-planner in Claude Code?
Run npx skills add microsoft/hve-core --skill functional-planner -a claude-code in your terminal to register the skill.
Does functional-planner modify remote trackers directly?
No, it enforces a read-only boundary. It validates schemas and writes reviewable files locally without touching remote tickets.
What credentials are needed for Jira planning?
You must provide JIRA_BASE_URL together with either JIRA_API_TOKEN or JIRA_PAT for read-only schema checks.