majiayu000/spellbook / skills/skill-ecosystem-doctor
skill-ecosystem-doctor
VerifiedAudit and safely repair cross-runtime Skill governance: canonical-source ownership, divergent or duplicate projections, exposure scopes and budgets, lifecycle drift, quarantine, and retirement. Use when the user explicitly requests cross-runtime or cross-scope Skill governance; ignore project-local Skill inventory, product/runtime loading or enablement checks, usage statistics, and mentions/traces.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.8 KB |
| agents/openai.yaml | config | 354 B |
| assets/remediation-log-template.md | markdown | 1.1 KB |
| assets/skill-governance.example.json | config | 1.2 KB |
| evals/evals.json | config | 5.1 KB |
| references/governance-schema.md | markdown | 9.4 KB |
| references/lifecycle-drift.md | markdown | 2.1 KB |
| references/remediation-playbook.md | markdown | 3.7 KB |
| references/runtime-contracts.md | markdown | 4.3 KB |
| requirements.txt | manifest | 7 B |
| scripts/ecosystem_checks.py | script | 14.1 KB |
| scripts/ecosystem_doctor.pyexecutable | script | 2.1 KB |
| scripts/ecosystem_exposure.py | script | 7.3 KB |
| scripts/ecosystem_governance.py | script | 11.9 KB |
| scripts/ecosystem_legacy.py | script | 11.8 KB |
| scripts/ecosystem_model.py | script | 8.6 KB |
| scripts/ecosystem_plugins.py | script | 2.6 KB |
| scripts/ecosystem_reconcile.py | script | 34.7 KB |
| scripts/ecosystem_runtimes.py | script | 4.6 KB |
| scripts/ecosystem_scans.py | script | 25.3 KB |
| scripts/ecosystem_split.py | script | 8.5 KB |
scripts/ecosystem_doctor.py
View on GitHub#!/usr/bin/env python3
"""Validate local Skill sources, projections, governance, and security signals."""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
from ecosystem_checks import validate_ecosystem
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument(
"--governance",
type=Path,
required=True,
help="Path to a schema-version 1 governance JSON file",
)
parser.add_argument("--json", action="store_true", dest="json_output")
parser.add_argument("--skip-loom", action="store_true")
parser.add_argument("--loom-binary", default="loom")
parser.add_argument("--fail-on-warn", action="store_true")
return parser
def main(argv: list[str] | None = None) -> int:
options = build_parser().parse_args(argv)
try:
result = validate_ecosystem(
options.governance,
run_loom=not options.skip_loom,
loom_binary=options.loom_binary,
)
except ValueError as exc:
if options.json_output:
print(json.dumps({"ok": False, "error": str(exc)}, ensure_ascii=False))
else:
print(f"ERROR: {exc}", file=sys.stderr)
return 2
if options.json_output:
print(json.dumps(result, ensure_ascii=False, indent=2))
else:
summary = result["summary"]
state = "PASS" if result["ok"] else "FAIL"
print(
f"{state}: {summary['instances']} instances, "
f"{summary['declared_names']} names, "
f"{summary['errors']} errors, {summary['warnings']} warnings"
)
for finding in result["findings"]:
location = f" {finding['path']}" if finding["path"] else ""
print(
f"[{finding['severity'].upper()}] {finding['code']}{location}: "
f"{finding['message']}"
)
if not result["ok"]:
return 1
if options.fail_on_warn and result["summary"]["warnings"]:
return 1
return 0
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |