skill-report

/skill-report — Skill Portfolio Report

Generate a comprehensive report of all installed skills: quick health scan, context budget, portfolio overview, and quality summary.

Arguments

• --skip-scan: Skip Quick Health Scan, only show Parts 2-4
• --scan-only: Only show Quick Health Scan (Part 1)

Steps

Step 1: Load Skill Inventory

Use the Read tool to load .skill-compass/setup-state.json. If the file does not exist, run /setup first and then continue from Step 2.

Extract the skill list from the inventory array. Each entry provides: name, path, version, purpose (category), modified_at. Keep the full list in memory.

If inventory is empty or missing, output:

No skills found in inventory. Run /setup to discover installed skills.

Then stop.

Step 2: Quick Health Scan (D1+D2+D3)

Skip this step entirely if --skip-scan was passed.

Build a skillEntries array from the inventory: [{ name, path, modified_at }, ...].

Run the QuickScanner using the Bash tool:

const { QuickScanner } = require('./lib/quick-scan');
const scanner = new QuickScanner('cc');
const skillEntries = /* array from inventory */;
const { results, summary } = scanner.scanAll(skillEntries);

Execute with node -e passing the constructed skillEntries inline, for example:

node -e "
const { QuickScanner } = require('./lib/quick-scan');
const scanner = new QuickScanner('cc');
const entries = {ENTRIES_JSON};
const out = scanner.scanAll(entries);
console.log(JSON.stringify(out));
"

Replace {ENTRIES_JSON} with the actual JSON array. Run this from the SkillCompass base directory ({baseDir}).

Sort results: high_risk first, then medium, then clean. Within each group, sort alphabetically by skill_name.

For skills that are disabled (check InboxStore.getSkillCache(name)?.disabled) or have ever_used === false from UsageReader.getSignals(name), mark them with verdict never_used for display purposes (use the ○ symbol).