pmo-team/skills/resource-allocation/SKILL.md
Resource capacity planning and allocation skill for managing people and skills across multiple projects. Identifies conflicts, gaps, and optimization opportunities.
npx skillsauth add lerianstudio/ring ring:resource-allocationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Systematic resource planning across portfolio for optimal utilization.
This skill provides a framework for:
Before resource allocation, ensure:
| Prerequisite | Required For | Source | |--------------|--------------|--------| | Resource inventory | Capacity baseline | HR/Resource management | | Project demands | Allocation needs | Project managers | | Skills matrix | Gap analysis | HR/Training | | Availability calendar | Time planning | Team calendars |
Objective: Establish baseline of available resources
Actions:
Output: docs/pmo/{date}/resource-inventory.md
Inventory Template:
| Resource | Role | Skills | Availability | Current Allocation | |----------|------|--------|--------------|-------------------| | [Name] | [Role] | [Skills] | [FTE] | [Projects] |
Objective: Understand resource demand across portfolio
Actions:
Demand Template:
| Project | Role/Skill | FTE Needed | Start | End | Priority | |---------|-----------|------------|-------|-----|----------| | [Project] | [Role] | [FTE] | [Date] | [Date] | [1-5] |
Output: docs/pmo/{date}/resource-demand.md
Objective: Identify mismatches between supply and demand
Actions:
Gap Types:
| Gap Type | Definition | Impact | |----------|------------|--------| | Capacity Gap | More work than people | Project delays, burnout | | Skill Gap | Work requires unavailable skills | Quality issues, training need | | Timeline Gap | Resources available wrong time | Schedule conflicts | | Quality Gap | Available skills below required level | Supervision needed |
Output: docs/pmo/{date}/resource-gaps.md
Objective: Resolve resource conflicts across projects
Actions:
Resolution Options:
| Option | When to Use | Trade-off | |--------|-------------|-----------| | Prioritize | Clear priority difference | Lower priority project delayed | | Share | Skills transferable | Context switching cost | | Hire | Long-term need | Time to onboard, cost | | Contract | Short-term need | Cost, knowledge transfer | | Defer | Flexibility exists | Opportunity cost | | Descope | Scope flexibility | Feature reduction |
Output: docs/pmo/{date}/conflict-resolution.md
Objective: Create optimal resource allocation plan
Actions:
Allocation Template:
| Resource | Project | Allocation % | Start | End | Notes | |----------|---------|--------------|-------|-----|-------| | [Name] | [Project] | [%] | [Date] | [Date] | [Notes] |
Utilization Target: 70-85% (leaves buffer for issues)
Output: docs/pmo/{date}/allocation-plan.md
See shared-patterns/anti-rationalization.md for universal anti-rationalizations.
| Rationalization | Why It's WRONG | Required Action | |-----------------|----------------|-----------------| | "Team said they can handle it" | Optimism bias is real. Validate with data. | Verify against utilization data | | "We'll figure it out as we go" | Resource chaos causes project failure. Plan upfront. | Complete allocation plan | | "100% utilization is optimal" | 100% = no buffer for issues, burnout. 70-85% is optimal. | Plan for sustainable utilization | | "Sharing resources is fine" | Context switching costs 20-40% productivity. Account for it. | Include switching cost in allocation |
See shared-patterns/pressure-resistance.md for universal pressure scenarios.
| Pressure Type | Request | Agent Response | |---------------|---------|----------------| | "Just assign everyone to both projects" | "100% allocation to multiple projects is impossible. Creating realistic allocation plan." | | "We don't have time to document skills" | "Skills documentation prevents misallocation. Completing skills inventory." | | "The team lead said resources are available" | "Trust and verify. Confirming with actual utilization data before committing." |
ALWAYS pause and report blocker for:
| Situation | Required Action | |-----------|-----------------| | Demand exceeds capacity by >20% | STOP. Report gap. Wait for prioritization or hiring decision. | | Critical skill unavailable | STOP. Report skill gap. Wait for training/hiring decision. | | Key person single point of failure | STOP. Report risk. Wait for mitigation decision. | | Conflicting executive commitments | STOP. Escalate conflict. Wait for resolution. |
The following requirements are NON-NEGOTIABLE:
| Requirement | Cannot Override Because | |-------------|------------------------| | Utilization limits (≤95%) | >95% sustained causes burnout and quality issues | | Conflict documentation | Unresolved conflicts cause project failures | | Skills verification | Assumed skills lead to delivery problems | | Availability confirmation | Committed resources must be verified before allocation | | Context switching accounting | Multi-project allocation must account for overhead |
If user insists on violating these:
When reporting resource issues:
| Severity | Criteria | Examples | |----------|----------|----------| | CRITICAL | Delivery at risk, burnout imminent | >110% sustained utilization, critical skill gap, key person leaving | | HIGH | Significant risk if not addressed | >100% temporary utilization, conflict between priority projects | | MEDIUM | Optimization opportunity | Suboptimal allocation, minor skill gaps, unbalanced teams | | LOW | Minor improvements possible | Process refinements, training opportunities |
Report ALL severities. Escalate CRITICAL immediately. Address HIGH this week.
# Resource Allocation Summary - [Date]
## Capacity Overview
| Metric | Value | Status |
|--------|-------|--------|
| Total FTE Available | X | - |
| Total FTE Demanded | X | - |
| Utilization Rate | X% | Green/Yellow/Red |
| Open Positions | N | - |
## Allocation by Project
| Project | FTE Allocated | Utilization | Status |
|---------|--------------|-------------|--------|
| [Project] | X | X% | Green/Yellow/Red |
## Gaps Identified
| Gap Type | Description | Impact | Resolution |
|----------|-------------|--------|------------|
| [Type] | [Description] | [Impact] | [Proposed] |
## Conflicts
| Conflict | Projects | Resource | Proposed Resolution |
|----------|----------|----------|---------------------|
| [ID] | [Projects] | [Resource] | [Resolution] |
## Recommendations
1. [Recommendation with rationale]
2. [Recommendation with rationale]
## Decisions Required
1. [Decision needed with options]
Base metrics per shared-patterns/execution-report.md:
| Metric | Value | |--------|-------| | Analysis Date | YYYY-MM-DD | | Scope | [Portfolio/Projects] | | Duration | Xh Ym | | Result | COMPLETE/PARTIAL/BLOCKED |
| Metric | Value | |--------|-------| | roles_analyzed | N | | allocation_conflicts | N | | utilization_average | X% | | gap_count | N |
| Condition | Verification | |-----------|-------------| | Recent allocation exists (<14 days) | Reference existing allocation plan | | No new projects started | Verify no new resource demands | | No resource changes | Confirm no departures, hires, or availability changes | | Utilization within targets (70-85%) | Verify no over/under allocation |
MUST: Full resource allocation REQUIRED for the following conditions:
| Condition | Why Required | |-----------|-------------| | New project starting | Resource demand must be planned | | Resource conflict identified | Resolution needed before escalation | | Team member departure/arrival | Reallocation required | | Utilization outside targets | Optimization or intervention needed | | Quarterly planning cycle | Regular capacity review required |
MUST: When in doubt, refresh the allocation plan. Stale resource data causes delivery failures.
development
Analyzes a Go service using lib-commons v2/v3 and generates a visual migration report showing every change needed to upgrade to lib-commons v4. Produces an interactive HTML page (via ring:visualize) and optionally generates refactoring tasks for ring:dev-cycle.
documentation
Patterns and structure for writing functional documentation including guides, conceptual explanations, tutorials, and best practices documentation.
development
Patterns and structure for writing API reference documentation including endpoint descriptions, request/response schemas, and error documentation.
documentation
Voice and tone guidelines for technical documentation. Ensures consistent, clear, and human writing across all documentation.