Docs Corpus Audit
microsoft/apm
A skill your agent uses to run a holistic regrounding pass on the entire microsoft/apm documentation corpus against current source code, page-by-page, and emit surgical fixes for stale claims.
A skill your agent uses when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract.
Install Skill Lifeguard
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install majiayu000/spellbook skill-lifeguard --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-lifeguard .claude/skills/skill-lifeguard && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .claude/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguardType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install majiayu000/spellbook skill-lifeguard --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/skill-lifeguard .agents/skills/skill-lifeguard && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .agents/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install majiayu000/spellbook skill-lifeguard --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/skill-lifeguard .cursor/skills/skill-lifeguard && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .cursor/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/majiayu000/spellbook.git --path skills/skill-lifeguard--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install majiayu000/spellbook skill-lifeguard --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/skill-lifeguard .gemini/skills/skill-lifeguard && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .gemini/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install majiayu000/spellbook skill-lifeguardInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/skill-lifeguard .github/skills/skill-lifeguard && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .github/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add majiayu000/spellbook --skill skill-lifeguard -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install majiayu000/spellbook skill-lifeguard --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/skill-lifeguard .opencode/skills/skill-lifeguard && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "skill-lifeguard" agent skill from https://github.com/majiayu000/spellbook/tree/main/skills/skill-lifeguard into .opencode/skills/skill-lifeguard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-lifeguard", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
skill-lifeguard- GitHub stars
- 287
- Token cost
- ~1.3k tokens
- SKILL.md length
- 590 words
- Files
- 3 (incl. references, assets)
- Skills in repo
- 97
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract.
- Works in 6 steps: Search before creating or moving skill… → Read the target skill and nearby docs… → Classify the skill maturity → …
- A skill is brittle
- SKILL.md covers Reliable Skill Contract, Workflow, Operating Contract and Gotchas, plus 5 more sections
- Calls python3
What it does
Skill Lifeguard is an agent skill from majiayu000/spellbook. 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.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files and assets (for example `assets/reliable-contract-template.md` and `references/examples.md`).
It sits in DevOps & Cloud, covering GitOps. The repository describes itself as: Cross-runtime skills for Claude Code, Codex, and multi-agent workflows. The licence is MIT.
When your agent uses it
- A skill is brittle
- Repeatedly failing
- Needs a Reliable Skill Contract
- Phrases like skill lifeguard
Example prompts
- “/skill-lifeguard”
Requirements
- Python 3
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Search before creating or moving skill files.
- Read the target skill and nearby docs that define its expected workflow.
- Classify the skill maturity
- Score the five contract elements as present, partial, missing, or deferred.
- Patch the smallest durable home: SKILL.md for routing and boundaries,
- Run repository validation and any skill-specific smoke check.
What it can do on your machine
Read from SKILL.md and the folder at commit ed52af7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Skill Lifeguard loads about 1.3k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 119 tokens; SKILL.md has 590 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from majiayu000/spellbook at commit ed52af7, republished under its MIT licence (© majiayu000). 590 words, ~1,297 tokens.
Download SKILL.mdSave it as
.claude/skills/skill-lifeguard/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- skill-lifeguard
- description
- 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.
Skill Lifeguard
Use this skill to make an existing or new skill self-maintaining enough for real
agent work. It complements skill-audit and skill-creator: use this skill for
the reliability contract, then use those skills for library fit and authoring.
Read references/examples.md when you need example contract wording. Use
assets/reliable-contract-template.md when drafting a reusable section.
Reliable Skill Contract
Every high-value workflow skill should either include these five elements or record why an element is intentionally deferred:
| Element | Required Evidence |
|---|---|
| Explicit negative examples | Named forbidden behaviors and concrete alternatives. |
| Verification checkpoints | Pass/fail checks after important phases, not only at the end. |
| Machine-checkable done conditions | Commands, assertions, artifacts, or state queries from the current session. |
| Replay or smoke hooks | A small way to rerun or sample the workflow, plus a log-to-patch loop. |
| Drift signal detection | Observable signs that the skill is stale, undertriggering, overtriggering, or producing false success. |
Workflow
- Search before creating or moving skill files.
- Read the target skill and nearby docs that define its expected workflow.
- Classify the skill maturity:
manual: workflow still needs human validation.skill: manually validated and packaged as reusable instructions.automation: repeatedly reliable and safe enough for scheduled or hook-driven use.
- Score the five contract elements as
present,partial,missing, ordeferred. - Patch the smallest durable home:
SKILL.mdfor routing and boundaries,references/for long examples,scripts/for deterministic checks,assets/ortemplates/for reusable report shapes. - Run repository validation and any skill-specific smoke check.
Operating Contract
- Direct actions: audit skill files, draft contract gaps, patch local skill instructions, and run local validation.
- Escalate before: publishing skills, installing into user runtime directories, deleting user files, changing secrets, or promoting manual workflows into scheduled automation.
- Evidence-backed pushback: refuse reliability claims that lack fresh verification, replay hooks, or drift signals.
- Feedback loop: turn repeated corrections, false-success signals, or failed smoke runs into a skill patch and rerun validation.
Gotchas
- A checklist without pass/fail evidence is not a checkpoint.
- A warning-only fallback can hide missing data; fail loud when output would be incomplete or misleading.
- A one-time successful manual run is not automation maturity.
Show full SKILL.md (240 more words)Show less
Output
For audits, lead with findings:
reliable_skill_contract:
- target:
- maturity:
- score:
negative_examples:
verification_checkpoints:
machine_done_conditions:
replay_or_smoke_hooks:
drift_signals:
- blocking_gaps:
- patch_plan:
- verification:For edits, keep the patch scoped to the missing contract elements. Do not rewrite the skill's domain behavior unless the reliability gap requires it.
Negative Examples
Reject these patterns and name the safer alternative:
- "Verify by saying it should work." Use a fresh command, fixture, or state query instead.
- "Swallow a failed helper and continue with a generic fallback." Surface the failure or mark the workflow blocked.
- "Add a broad reminder to be careful." Add a concrete forbidden behavior and an allowed replacement.
- "Automate a workflow that has never passed manually." Keep it in
manualmaturity and add smoke checks first.
Checkpoints
Place checkpoints where a future agent could otherwise drift:
- after startup discovery and applicable instructions are read
- before edits that touch high-context files or generated metadata
- after each deterministic verification command
- before commit, push, PR, merge, or automation
- after a failure log produces a skill patch
Drift Signals
Treat these as evidence to patch the skill:
- users repeat the same correction
- the skill triggers for the wrong task boundary
- the skill fails to trigger for its primary phrase
- the expected verification command no longer exists
- output format changes without downstream docs or examples changing
- a silent fallback hides missing data, auth, files, or external state
Verification
For Spellbook skills, run:
python3 ./scripts/validate_skills.py --check
python3 ./scripts/audit_skill_quality.py skill-nameIf the skill owns scripts, also run the relevant syntax check or fixture. Report missing prerequisites instead of marking the contract complete.
© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references, assets) in skills/skill-lifeguard of majiayu000/spellbook.
- SKILL.md
- assets/reliable-contract-template.md
- references/examples.md
Open the folder on GitHubat commit ed52af7
Compare with similar skills
Skill Lifeguard next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Skill Lifeguard this skillmajiayu000/spellbook | 287 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Docs Corpus Auditmicrosoft/apm | 4k | — | ~2.6k | Automated safety check: Pass | MIT | |
| Kubernetes SpecialistJeffallan/claude-skills | 12k | 1 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Kubernetes ArchitectCybereason-Public/owLSM | 280 | 9 repos | ~2.6k | Automated safety check: Pass | GPL-2.0 | |
| Devopsnicepkg/auto-company | 195 | 2 repos | ~814 | Automated safety check: Pass | MIT | |
| Gitops Repo Auditfluxcd/agent-skills | 231 | — | ~3.8k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Kubernetes Specialist
Jeffallan/claude-skills
Creates and checks Kubernetes manifests, Helm charts, RBAC and network policies, and helps debug pod problems, with kubectl checks and rollback steps.
Kubernetes Architect
Cybereason-Public/owLSM
Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration.
Devops
nicepkg/auto-company
Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Kubernetes (kubectl, Helm).
Gitops Repo Audit
fluxcd/agent-skills
Audit and validate Flux CD GitOps repositories by scanning local repo files (not live clusters) — runs Kubernetes schema validation, detects deprecated Flux APIs, reviews RBAC/multi-tenancy/secrets…
GitOps with ArgoCD and Flux
wshobson/agents
Sets up GitOps continuous delivery for Kubernetes with ArgoCD or Flux, covering installation, repository layout, sync policies, progressive delivery and secrets.
More from majiayu000/spellbook
All 97 skills in this repoSkill Ecosystem Doctor
majiayu000/spellbook
Audits and repairs how coding-agent Skills are owned, copied and exposed across runtimes, from canonical sources to quarantine and retirement.
AGENTS.md Scaffold
majiayu000/spellbook
Scans a repository for real evidence and proposes, or on request writes, a small stack of root and scoped AGENTS.md files with validation commands and generated-file boundaries.
Product Demo Builder
majiayu000/spellbook
Plans, produces or diagnoses evidence-backed product demo videos: script, capture plan, pacing checks and verified final media built on real product behavior.
Flowguard Task Guard
majiayu000/spellbook
Single entry point that routes long or ambiguous agent tasks, checks live state, bounds autonomous loops and leaves a resumable handoff.
npm Supply Chain Check
majiayu000/spellbook
Scans a repository, its lockfiles and node_modules for known malicious npm package versions and install-time indicators, using a read-only Python scanner.
Product Manager Toolkit
majiayu000/spellbook
Product management helpers: a RICE scoring script, an interview transcript analyzer and PRD templates for prioritizing features, synthesizing research and writing requirements.
Related
Categories
Questions about Skill Lifeguard
What does Skill Lifeguard do?
A skill your agent uses when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract. Skill Lifeguard is an agent skill from majiayu000/spellbook. Use when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract.
When should I use Skill Lifeguard?
Skill Lifeguard fits situations like: A skill is brittle; repeatedly failing; needs a Reliable Skill Contract; phrases like skill lifeguard.
How do I install Skill Lifeguard in Claude Code?
Run `npx skills add majiayu000/spellbook --skill skill-lifeguard -a claude-code`. Or copy the skill folder (skills/skill-lifeguard in majiayu000/spellbook) into .claude/skills/skill-lifeguard in your project. Claude Code loads it when a task matches its description.
How do I install Skill Lifeguard in Codex?
Run `npx skills add majiayu000/spellbook --skill skill-lifeguard -a codex`. Or copy the skill folder (skills/skill-lifeguard in majiayu000/spellbook) into .agents/skills/skill-lifeguard in your project. Codex loads it when a task matches its description.
Can I use Skill Lifeguard in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/spellbook --skill skill-lifeguard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-lifeguard, .gemini/skills/skill-lifeguard, .github/skills/skill-lifeguard and .opencode/skills/skill-lifeguard in your project.
What does Skill Lifeguard need to run?
Going by SKILL.md and its folder, Skill Lifeguard needs the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Skill Lifeguard access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Skill Lifeguard safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Skill Lifeguard use?
Skill Lifeguard is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Skill Lifeguard use?
About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 380 tokens, read only when the agent opens those files.
What are the alternatives to Skill Lifeguard?
Skills that share tags, products or a category with Skill Lifeguard: Docs Corpus Audit (microsoft/apm, 4k stars), Kubernetes Specialist (Jeffallan/claude-skills, 12k stars), Kubernetes Architect (Cybereason-Public/owLSM, 280 stars) and Devops (nicepkg/auto-company, 195 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Skill Lifeguard?
majiayu000 (a GitHub user) maintains it in majiayu000/spellbook, which has 287 GitHub stars. The repository holds 97 skills in this directory. The repository was last updated on October 8, 2026.
Source: majiayu000/spellbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.