majiayu000/spellbook / skills/skill-lifeguard
skill-lifeguard
VerifiedUse when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract. Trigger for phrases like skill lifeguard, reliable skill, self-maintaining skill, negative examples, verification checkpoints, drift signals, replay hooks, or failure log to skill patch. Audits or patches skills so high-value workflows include explicit forbidden behaviors, checkpoints, machine-checkable done conditions, replay or smoke hooks, and drift detection.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.1 KB |
| assets/reliable-contract-template.md | markdown | 424 B |
| references/examples.md | markdown | 1.5 KB |
references/examples.md
View on GitHub# Reliable Skill Contract Examples
Use these examples as patterns, not as text to paste blindly.
## Workflow Skill
```text
Forbidden behavior:
- Do not claim PR readiness from green CI alone.
Required alternative:
- Query current head SHA, check rollup, merge state, and GraphQL reviewThreads.
Checkpoint:
- Before merge, rerun the PR gate against the current head.
Done condition:
- Merge command uses --match-head-commit and post-merge PR state is MERGED.
Replay hook:
- Run the PR gate against a known fixture PR and record any false positives.
Drift signal:
- Review comments ask for the same missing evidence twice.
```
## Content Skill
```text
Forbidden behavior:
- Do not invent source facts when the input has no data.
Required alternative:
- Return a blank section or ask for the missing source.
Checkpoint:
- Before final output, scan every factual claim back to an input note or citation.
Done condition:
- Output includes the required sections and no unsupported claims.
Replay hook:
- Run one empty-input fixture and one noisy-input fixture.
Drift signal:
- The skill starts producing generic filler when input is sparse.
```
## Failure Log To Patch
```text
failure_signal:
- User corrected that explicit --extra-root paths were silently ignored.
root_cause:
- The skill documented explicit scanning but the helper filtered missing paths.
patch:
- Add a fail-loud validation checkpoint for explicit paths.
verification:
- Fixture command exits non-zero for a missing explicit path.
```
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 |