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 |
references/lifecycle-drift.md
View on GitHub# Lifecycle drift review
Use this reference when a Skill stopped triggering after a runtime upgrade,
contains time-sensitive dependencies, or has not been verified recently.
## Evidence order
1. Identify the canonical owner and every active projection.
2. Read Git history, package or plugin version records, installer pins, current
runtime configuration, and fresh test output.
3. Record optional metadata such as `version`, `last_verified`, `tested_on`,
`external_deps`, or `provenance` when it exists. An absent field means
`unknown`; it is not a failure by itself.
4. For an external repository, API, package, or model, verify the current
contract through an authoritative source before claiming it is live, changed,
or gone. If network evidence is unavailable, mark the dependency `unverified`.
5. For trigger drift, compare the current frontmatter description with current
runtime discovery behavior and reproduce the missed trigger when possible.
Do not infer a runtime matching rule from an old model name or anecdote.
## Status vocabulary
- `verified`: fresh source-specific tests and runtime resolution support the
current contract.
- `needs_verification`: the source is coherent, but fresh behavioral evidence
is missing.
- `stale`: current evidence proves a dependency, trigger, or runtime assumption
no longer holds.
- `blocked_external`: verification or repair requires an unavailable account,
service, license, or remote permission.
- `unknown`: required evidence was not found; do not convert this to a score.
## Report fields
For each affected Skill report:
- declared name and canonical owner;
- source and active projection paths;
- most recent verifiable test, commit, package, and usage evidence;
- external dependency status with the supporting source;
- trigger reproduction evidence;
- status and concrete risk;
- smallest repair, rollback path, and fresh verification command.
Do not require every Skill to embed a copied health block, an arbitrary number
of trigger phrases, or speculative version metadata. Update maintenance fields
only after the corresponding test or source check actually ran.
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 |