Revealui skills test

Skill RevealUIStudio/revskills/skills/revealui-skills-test

Static validator for Studio Agent Skills. Dry-runs skill roots (revskills SoT + equal-adapter command/skill homes), validates referenced scripts exist, flags stale ~/suite/ paths and rule violations. Read-only.From its SKILL.md

Install

npx -y skills add RevealUIStudio/revskills --skill revealui-skills-test

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.6 KB, as published. Nobody here has run it

Validate skill installs without requiring a Claude-only command dir. Goal: catch broken skills (stale paths, missing scripts, rule-violating commands) before invoke.

Load helpers:

. "$HOME/revfleet/revskills/scripts/lib/session-state.sh"

Roots to scan (in order)

SoT (always): $HOME/revfleet/revskills/skills/*/SKILL.md
Adapter homes (when present):
- ~/.claude/commands/*.md (Claude slash / command links)
- ~/.grok skill pointers if listed in config, or paths under [skills].paths
- Optional: REVSKILLS_COMMAND_DIRS colon list (same as lint-all-skills)

Never FAIL solely because ~/.claude/commands is missing.

For each skill file

1. Frontmatter

If frontmatter present, confirm valid YAML-ish (--- open/close).
Confirm description is non-empty when frontmatter exists.

2. Referenced scripts

Extract paths matching:

$HOME/.claude/... or ~/.claude/...
$HOME/.grok/... or ~/.grok/...
$HOME/revfleet/revskills/... or ~/revfleet/revskills/...
bash "<path>" / node "<path>" / tsx "<path>"

Assert each target exists. Missing = FAIL.

3. Referenced repos

Extract ~/revfleet/..., ~/projects/..., ~/suite/....
~/suite/* = FAIL (retired). Missing ~/revfleet/* = FAIL.

4. Rule compliance (awk linter)

awk -f "$HOME/revfleet/revskills/scripts/lib/lint-skill.awk" <skill>

Tags: stale-suite-path, git-C-violates-bash.md, pnpm-dir-violates-bash.md, inline-node-e-violates-hooks.md, tmux-legacy.

5. CLI soundness

For known CLIs (revvault, pnpm, nix, gh, git, …): presence on PATH when invoked in skill code blocks.

6. Status marker

DISABLED in first H1/frontmatter → SKIP.

Batch / CI (no interactive harness required)

bash "$HOME/revfleet/revskills/scripts/lint-all-skills.sh"
bash "$HOME/revfleet/revskills/scripts/lint-all-skills.sh" --json

Exits 0 on clean, 1 on violation. Preferred pre-push path.

Output

skill              status   issues
revealui-recover   PASS     -
…

JSON sidecar: /tmp/revealui-skills-test-last.json.

Do not

Do not execute skill bodies — parse statically only.
Do not modify any file — read-only validator.