ClawHub
SkillsPluginsOfficialDocsSupport
K
skills/gold3bear/skill-vitals
Other
#skill-management#context-management#security-audits#cost-optimization

Skill Vitals — Skill Audit

Audit installed skills, cost, conflicts, and risk

Bear Xiong@gold3bear

Skill Vitals

Audit an installed skill library and report cost versus value with concrete actions.

The scanner measures, doctor diagnoses, and you judge what neither can decide. Keep those three separate, and never turn an unavailable field into a guessed value.

1. Run one host at a time

bash
python3 scripts/scan.py doctor --host claude-code

Hosts: claude-code, codex, openclaw, hermes, workbuddy. Never combine context budgets or conflicts across hosts — run one report per runtime.

Use --path <dir> when the inventory is clearly incomplete. Use --all only to diagnose why installed copies did not load; never present its aggregate as the active context cost.

Host evidence differs and degrades explicitly. Read references/hosts.md before reporting on any host other than Claude Code, or whenever a field comes back unavailable.

2. Read the diagnosis

doctor prints each finding as an SV code with cause, impact, and action, followed by ! caveat lines and a "Not assessed" section naming what it deliberately refuses to judge. Carry those caveats into your report verbatim in substance — do not reword them into something more confident, and do not drop them.

CodeMeaning
SV001 / SV002description budget warning / overflow
SV101 / SV102 / SV103shadowed by newer / redundant copy / intentional override
SV105invalid or missing frontmatter
SV201 / SV202zero triggers / dormant
SV301 / SV303high per-trigger cost / expensive and unused
SV401lexical overlap candidate
SV501–SV508security findings
SV901 / SV902capability unavailable / skill unreadable

Drill down only where the diagnosis points:

bash
python3 scripts/scan.py explain <name>   # why one skill is ineffective, and the fix
python3 scripts/scan.py list --unused    # dormant and zombie candidates
python3 scripts/scan.py overlap          # the shared terms behind SV401
python3 scripts/scan.py diff             # what changed since the last snapshot
python3 scripts/scan.py --json -         # raw measurements, when you need a field

doctor writes a snapshot and compares against the previous one automatically; --no-snapshot turns that off. Add --redact --redact-names before sharing any output.

3. Supply the judgment the tool withholds

The codes below are where doctor stops and you start. Read references/judgment.md when any of them appears:

  • SV401 — is the overlap real? Lexical similarity is a filter, not a verdict.
  • SV101 / SV103 — which copy should win, and does the user know which one is effective?
  • SV301 / SV303 — where exactly should this skill be split?
  • SV501–SV508 — review every flagged line manually. cited=true changes reading order only; it never suppresses or downgrades a finding.
  • SV201 / SV202 — genuinely dead, or simply never selected?

4. Report format

Lead with the conclusion, then the evidence:

markdown
# Skill health report

## Critical finding
Only when budget overflow, a high-severity conflict, or a serious security finding exists.

## Overview
Host and instance · run <marker> · installed N · active/runtime-verified M · estimated Tier 1 cost · evidence availability

## Immediate actions
1. `SV___` — concrete action naming the skill and its path

## Context cost
`SV301` / `SV303` — highest-cost skills, distinguishing core / references / worst case

## Conflicts and semantic overlap
`SV101` / `SV103` / `SV401` — effective copy, shadowed copies, and a realistic prompt that would trigger both

## Usage evidence
`SV201` / `SV202` — measured counters, or an explicit statement that they are unavailable

## Security and structure
`SV501`–`SV508` / `SV105` — reviewed findings with file and line evidence

## Recommended disposition
Keep · revise · merge · disable/delete after confirmation

Every recommendation must be executable and name the affected skill. Cite the SV code each finding answers, so the reader can re-run with the same run marker and land on that exact line — and if a finding has no SV code to cite, doctor did not report it and you should ask yourself where it came from.

5. Interaction rules

  • Never delete or disable a skill unless the user explicitly asks.
  • Every number, skill name, and path in your report is copied from the scan output. Do not compute one, round one, or recall one — if it is not in the output, it does not go in the report. The same holds for doctor's ! caveats: reproduce their substance or drop the finding with them, because a finding stripped of its caveat reads as a verdict.
  • Quote doctor's run marker in the report header. It is derived from this scan's contents, so it is the reader's evidence that the report describes a scan you actually ran rather than one you remember.
  • Label token counts as estimates, trigger counters as measurements, and semantic overlap as your own judgment.
  • When a capability is unavailable, say so and omit the claim entirely. A report missing a column is useful; a report with a fabricated one is not.
  • Splitting a skill lowers average load cost, not necessarily worst-case cost — name which number dropped.

For the complete Chinese workflow, read references/guide.zh-CN.md when the user requests Chinese or when Chinese terminology would improve the report.

Downloads
Security audit
Pass
Last updated
3mo ago
Current version
v1.2.0
License
MIT-0

Install

$
openclaw skills install @gold3bear/skill-vitals
Downloads
Security audit
Pass
Last updated
3mo ago
Current version
v1.2.0
License
MIT-0
ClawHub

Skills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem.

Explore docs

SkillsPluginsOfficialAudits

Publish SkillPublish PluginCreate org

OverviewOpenClawDocsBlog

SupportGitHubDiscord

Built alongside the OpenClaw ecosystem

LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects

© 2026 OpenClaw Foundation

Privacy policy·Status·Deployed on Vercel·Powered by Convex

....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals