Skill Health Monitor

Reports ecosystem health for toolforge/skills using actual manifest.json and directory data.

Trigger

npm run health-check -- --staleDays 30

Input Schema

interface HealthInput {
  manifestPath?: string;  // Default: toolforge/manifest.json
  skillsDir?: string;     // Default: toolforge/skills
  staleDays?: number;     // Default: 30
}

Output Schema

interface HealthOutput {
  status: "success" | "error";
  reportDate: string;
  totalSkills: number;
  neverRun: string[];
  stale: string[];
  orphanedEntries: string[];
  unregisteredDirs: string[];
  healthScore: number;
  recommendations: string[];
  timestamp: string;
}

---

Full reference: See Skill Operator Guide.

For health score calculation, usage examples: See docs/USAGE.md.