Agent skill
stakeholder-tracking
Define stakeholder personas and track their goals to ensure all perspectives are addressed
Install this agent skill to your Project
npx add-skill https://github.com/britt/claude-code-skills/tree/main/skills/stakeholder-tracking
SKILL.md
Stakeholder Tracking
Purpose
Help users define stakeholder personas and track their goals, ensuring all perspectives are addressed throughout the project lifecycle.
When to Use This Skill
- Starting a new project and need to identify stakeholders
- Planning features and want to ensure all perspectives are covered
- Reviewing a plan to check stakeholder coverage
- Resolving conflicts between different stakeholder needs
- Linking GitHub issues to stakeholder goals
Stakeholder Note Format
Each stakeholder is stored as a note with YAML content. Use the title format "Stakeholder: [Name]" for easy searching.
type: stakeholder
name: End User
role: Product manager
description: Uses LLPM for specs and planning
goals:
- Quickly create well-formed issues
- AI assistance for gap analysis
painPoints:
- Writing specs is time-consuming
- Context switching between tools
priorities:
- Context
- Quality
- Integration
linkedIssues:
- goal: "Quickly create well-formed issues"
issues: [42, 56]
Workflow
Adding Stakeholders
When a user wants to add a stakeholder, engage conversationally:
- Ask for the stakeholder's name and role
- Ask for a brief description
- Ask about their goals (what do they want to achieve?)
- Ask about pain points (what frustrates them currently?)
- Ask about priorities (what matters most, in order?)
- Confirm the profile and save using the YAML format above
Listing Stakeholders
When asked to list stakeholders:
- Search for all stakeholder profiles (e.g., by "type: stakeholder")
- Present a summary table with name, role, and top goals
Viewing Stakeholder Details
When asked about a specific stakeholder:
- Search for the stakeholder by name
- Present the full profile with goals, pain points, and linked issues
Updating Stakeholders
When asked to update a stakeholder:
- Find the stakeholder profile
- Retrieve the full content
- Make the requested changes
- Save the updated profile
Removing Stakeholders
When asked to remove a stakeholder:
- Find the stakeholder profile
- Confirm deletion with the user
- Remove the profile
Linking Issues to Goals
When an issue addresses a stakeholder goal:
- Find the stakeholder profile
- Add the issue number to the
linkedIssuessection under the matching goal - Save the updated profile
Checking Coverage
When asked about stakeholder coverage:
- Find all stakeholder profiles
- Fetch open issues to check goal-issue linkage
- For each stakeholder, check which goals have linked issues and which don't
- Calculate coverage percentages
- Present a coverage report highlighting gaps
Coverage report format:
## Stakeholder Coverage Report
### End User (2/3 goals covered - 67%)
- [x] Quickly create well-formed issues (linked: #42, #56)
- [x] AI assistance for gap analysis (linked: #78)
- [ ] **GAP**: Fast context switching - no issues address this
### Product Owner (1/2 goals covered - 50%)
- [x] Track project progress (linked: #12)
- [ ] **GAP**: Stakeholder visibility - no issues address this
### Overall Coverage: 60% (3/5 goals linked to issues)
Resolving Conflicts
When stakeholder priorities might conflict:
- Identify the conflicting priorities by comparing stakeholder profiles
- Present the conflict clearly to the user
- Offer resolution options:
- Prioritize one stakeholder's needs
- Find a compromise
- Document as a known tradeoff
- Record the resolution by updating the relevant stakeholder notes
Natural Language Triggers
Respond to these types of questions:
| Question Type | Action |
|---|---|
| "Who are the stakeholders?" | Find and list all stakeholder profiles |
| "Add a stakeholder" | Start conversational profile creation |
| "What are [Name]'s goals?" | Find and show specific stakeholder's goals |
| "Does this address stakeholder concerns?" | Generate coverage report |
| "Show me stakeholder coverage" | Generate coverage report |
| "Link issue #X to [goal]" | Update stakeholder profile with issue link |
| "Are there any conflicts?" | Compare stakeholder priorities for conflicts |
Best Practices
- Start with key stakeholders: Focus on 3-5 primary stakeholders initially
- Be specific with goals: "Complete checkout in under 2 minutes" is better than "Fast checkout"
- Link issues early: When creating issues, immediately link them to relevant goals
- Review coverage regularly: Check coverage when planning sprints or releases
- Document conflicts: When priorities conflict, record the decision and rationale
Didn't find tool you were looking for?