legion:portfolio-manager

Aggregates STATE.md and ROADMAP.md across registered projects into a portfolio dashboard with dependencies and health assessments.

72|8|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/9thLevelSoftware/legion --skill legion-portfolio-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: legion:portfolio-manager
Source: https://github.com/9thLevelSoftware/legion/tree/main/skills/portfolio-manager
Command: npx skills add https://github.com/9thLevelSoftware/legion --skill legion-portfolio-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a single, consistent view of many independent projects by registering each project's metadata, aggregating per-project state, and surfacing cross-project dependencies and health so program leads and producers can prioritize work and resolve blockers.

Core Features & Use Cases

  • Portfolio Registry: Maintain a global portfolio.md registry with project paths, status, and metadata to discover projects from any working directory.
  • State Aggregation & Health: Read each project's .planning/STATE.md and .planning/ROADMAP.md to compute per-project progress, last activity, and a Green/Yellow/Red health assessment using defined rules and the execution-tracker formula.
  • Cross-Project Dependencies & Agent Allocation: Add/remove/check dependencies between project phases and map agent usage across projects to identify shared agents and division spread.
  • Use Case: A studio producer registers 20 microservice projects, views an aggregated dashboard to find blocking dependencies and reallocates agents to accelerate a critical release.

Quick Start

Register the current project and generate a portfolio dashboard that aggregates STATE.md and ROADMAP.md across registered projects.

Frequently Asked Questions about legion:portfolio-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I aggregate project state across multiple local project directories?

Aggregate project state by reading each project's .planning/STATE.md and .planning/ROADMAP.md files, computing per-project progress percentages, and registering the results in a global portfolio.md dashboard.

What is cross-project dependency tracking and how does it work for a project portfolio?

Cross-project dependency tracking evaluates blocking relationships between project phases by mapping dependencies in a central registry, computing statuses, and surfacing health assessments to prioritize work and resolve blockers.

How do I generate a cross-project portfolio dashboard with health assessments?

Generate a portfolio dashboard by registering multiple project paths, parsing their roadmap and state formats to compute execution-tracker progress, and applying Green/Yellow/Red health assessment rules to aggregate state.

Can I map agent allocation and usage across multiple projects?

Map agent allocation by reading registered project metadata to identify shared agents and division spread across the portfolio, producing an agent allocation summary for reallocating resources to accelerate releases.

Do I need a specific planning format to use cross-project state aggregation?

State aggregation requires each project to contain a .planning/STATE.md and .planning/ROADMAP.md file to compute execution-tracker progress percentages and evaluate cross-project dependency statuses.

What is the best way to manage a portfolio of independent microservice projects?

Manage a microservice portfolio by registering all project paths in a global portfolio.md registry, aggregating per-project state, and surfacing cross-project dependencies and health to prioritize work and resolve blockers.