Skip to content

majiayu000/spellbook / skills/skill-lifeguard

skill-lifeguard

Verified

Use 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.

FileKindSize
SKILL.mdskill md5.1 KB
assets/reliable-contract-template.mdmarkdown424 B
references/examples.mdmarkdown1.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.
```
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall