Vercel Composition Patterns
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
.claude/skills//SKILL.md の frontmatter / referenced script 実在 / trigger 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill。
Install Skill Health
$ npx skills add ayutaz/piper-plus --skill skill-health -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ayutaz/piper-plus skill-health --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/ayutaz/piper-plus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/skill-health .claude/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .claude/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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/ayutaz/piper-plus/tree/dev/.claude/skills/skill-healthType 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 ayutaz/piper-plus --skill skill-health -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ayutaz/piper-plus skill-health --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/skill-health .agents/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .agents/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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 ayutaz/piper-plus --skill skill-health -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ayutaz/piper-plus skill-health --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/skill-health .cursor/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .cursor/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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/ayutaz/piper-plus.git --path .claude/skills/skill-health--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 ayutaz/piper-plus --skill skill-health -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ayutaz/piper-plus skill-health --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/skill-health .gemini/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .gemini/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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 ayutaz/piper-plus skill-healthInstalls 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 ayutaz/piper-plus --skill skill-health -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/skill-health .github/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .github/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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 ayutaz/piper-plus --skill skill-health -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ayutaz/piper-plus skill-health --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/skill-health .opencode/skills/skill-health && 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-health" agent skill from https://github.com/ayutaz/piper-plus/tree/dev/.claude/skills/skill-health into .opencode/skills/skill-health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-health", 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-health- GitHub stars
- 234
- Token cost
- ~626 tokens
- SKILL.md length
- 221 words
- Files
- 1
- Skills in repo
- 20
- Repo updated
- First seen
- Licence
- MIT
At a glance
.claude/skills//SKILL.md の frontmatter / referenced script 実在 / trigger 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill。
- Works in 3 steps: 検査スクリプト実行 → 失敗時の対応 → CI 連携
- 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill
- SKILL.md covers カバー範囲, 実行ステップ, 注意 and 使用例, plus 1 more section
- Calls uv
What it does
Skill Health is an agent skill from ayutaz/piper-plus. .claude/skills//SKILL.md の frontmatter / referenced script 実在 / trigger 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill。 メタワークフロー監査で「hook script rot が最高リスク」と判明したため、 commit 前または skill 編集後に呼んで health check を行う。
Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development. The repository describes itself as: Multilingual neural TTS (6 languages: JA/EN/ZH/ES/FR/PT, code supports SV) — C++, C, Rust, Go, Python, npm (WASM). VITS + Prosody, streaming, CUDA/CoreML/DirectML. pip install…. The licence is MIT.
When your agent uses it
- 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill
Example prompts
- “/skill-health”
Requirements
- Python 3
- Pre-approved tools (allowed-tools): Bash(uv run *), Bash(ls *), Bash(test *), Bash(file *), Bash(stat *), Read, Grep
Workflow steps
3 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit b5f6073. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Bash(uv run *)Bash(ls *)Bash(test *)Bash(file *)Bash(stat *)ReadGrep
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
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 Health loads about 626 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 221 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 ayutaz/piper-plus at commit b5f6073, republished under its MIT licence (© ayutaz). 221 words, ~626 tokens.
Download SKILL.mdSave it as
.claude/skills/skill-health/SKILL.md (or your agent's skills folder).- name
- skill-health
- description
- `.claude/skills/*/SKILL.md` の frontmatter / referenced script 実在 / trigger 衝突 / `.claude/hooks/*.sh` の executable+shebang を検査する meta-skill。 メタワークフロー監査で「hook script rot が最高リスク」と判明したため、 commit 前または skill 編集後に呼んで health check を行う。
- allowed-tools
- Bash(uv run *), Bash(ls *), Bash(test *), Bash(file *), Bash(stat *), Read, Grep
- disable-model-invocation
- false
Skill / Hook Health Check
このプロジェクトの自動化資産 (16 skill + 5 hook + 49 pre-commit hook) を meta-level で健全性検証する。
memory feedback_conservative_changes.md に従い、 read-only、 検査結果を report として返すのみ。 修正は別 skill / 手動で。
カバー範囲
| 検証対象 | 内容 |
|---|---|
| SKILL.md frontmatter | name / description / allowed-tools の必須 key、 description 長 |
| name ↔ directory 一致 | .claude/skills/foo/SKILL.md の name: foo であること |
| scripts/*.py 参照 | SKILL.md 内で参照されるスクリプトが repo 内に実在 |
| trigger 衝突 | 複数 skill の description で同じ 「...」 が使われていないか |
| hook 実行可能性 | .claude/hooks/*.sh の executable bit + shebang |
実行ステップ
1. 検査スクリプト実行
uv run python scripts/check_skill_health.py --verbose期待出力例:
inspected 16 skills, 5 hooks
OK skill-health: 16 skill(s), 5 hook(s) inspected2. 失敗時の対応
| エラー種別 | 修正案 |
|---|---|
frontmatter not parseable | YAML 構文エラー。 --- 行 + key: value を見直す |
missing frontmatter key: name | SKILL.md 冒頭に name 追加 |
name does not match directory | ディレクトリ名と SKILL.md の name を揃える |
references <path> but file does not exist | 参照されるスクリプトを作るか SKILL.md から消す |
trigger fragment used by: [...] | 複数 skill で同じ trigger 文言 → どちらかを書き換えて曖昧性除去 |
not executable | chmod +x .claude/hooks/*.sh |
no shebang on line 1 | #!/usr/bin/env bash を 1 行目に追加 |
3. CI 連携
このチェック自体は CI gate にする選択もあるが、 false positive (trigger 衝突警告は意図的なケースもある) のため pre-commit には入れずに skill 経由で呼ぶ。
将来、 false positive を減らせた段階で pre-commit hook 化を検討。
注意
- memory feedback_conservative_changes: 自動修復しない。 検査結果のみ。
- trigger 衝突: 「コミット前」 のような短い fragment は多数 skill に出現しても問題ないが、 「6 エージェント並列レビュー」 のような特定 skill 専用文言が他に漏れていたら衝突。
- frontmatter 長さ警告: description は 80-400 chars が推奨。 800 chars 超は単一文を超えており指針違反。
使用例
# 全 skill / hook の health check
/skill-health
# verbose で全 skill / hook を一覧
/skill-health verbose期待効果
- skill / hook の script reference rot を pre-commit 入れなくても定期検査可
name ↔ directoryミスマッチ (skill 追加時の rename 忘れ) の早期発見- trigger 衝突 の検出 (どの skill が呼ばれるべきか LLM に曖昧)
.claude/hooks/*.shの shebang 漏れ / executable 漏れ 防止
© ayutaz, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/skill-health of ayutaz/piper-plus.
Open the folder on GitHubat commit b5f6073
Compare with similar skills
Skill Health 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 Health this skillayutaz/piper-plus | 234 | — | ~626 | Automated safety check: Pass | MIT | |
| Vercel Composition Patternssupabase/supabase | 111k | 58 repos | ~726 | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Typescript Advanced Typesrolling-scopes/rsschool-app | 10k | 25 repos | ~4.2k | Automated safety check: Pass | MPL-2.0 | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 4 repos | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
- Official
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
Typescript Advanced Types
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
More from ayutaz/piper-plus
All 20 skills in this repoBump Deps
ayutaz/piper-plus
ORT / openjtalk / ruff のような cross-runtime に canonical sync が必要な依存関係を 1 コマンドで bump する read-mostly skill。
Check Cross Runtime
ayutaz/piper-plus
Python canonical (src/pythonrun/piperplus/, src/python/pipertrain/, src/python/g2p/piperplusg2p/) を変更した PR で、 ONNX I/O 以外の追随漏れ (phonemizer / config schema / CLI flag / data 形式 / API 変更) を 7 ランタイム +…
Check Loanword
ayutaz/piper-plus
ZH-EN code-switching loanword の同期と forward-compat を 1 コマンドで検査。zhenloanword.json を編集したり 5 ランタイムのいずれかに新規エントリを追加する前後に呼ぶ。Python source を canonical とし、Rust×2 / Go / C / WASM / C++ の 6 mirror + Python…
Check New Runtime Asset
ayutaz/piper-plus
新規データアセット (JSON/TOML) を追加した PR で「7 箇所の package metadata 更新が全て揃っているか」を 1 コマンドで確認。MANIFEST.in / pyproject package-data / Cargo features / npm files / C Content / Android assets / SPM resources の更新漏れを…
Check PR Ready
ayutaz/piper-plus
PR 作成前の最終チェックリスト (lint/test/docs/CHANGELOG/未コミット確認)。/precheck の拡張版で、ドキュメント整合性も検証します。
Check Pua
ayutaz/piper-plus
PUA テーブル / fixture / config の整合性を 1 コマンドで検査。pua.json を編集したり ɔɪ/œ̃/ɐ̃ のような multi-codepoint 音素を扱う前後に呼ぶ。docs/spec/pua-contract.toml の 4 不変条件を全部チェック。
Related
Categories
Questions about Skill Health
What does Skill Health do?
.claude/skills//SKILL.md の frontmatter / referenced script 実在 / trigger 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill。. Skill Health is an agent skill from ayutaz/piper-plus.
When should I use Skill Health?
Skill Health fits situations like: 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill.
How do I install Skill Health in Claude Code?
Run `npx skills add ayutaz/piper-plus --skill skill-health -a claude-code`. Or copy the skill folder (.claude/skills/skill-health in ayutaz/piper-plus) into .claude/skills/skill-health in your project. Claude Code loads it when a task matches its description.
How do I install Skill Health in Codex?
Run `npx skills add ayutaz/piper-plus --skill skill-health -a codex`. Or copy the skill folder (.claude/skills/skill-health in ayutaz/piper-plus) into .agents/skills/skill-health in your project. Codex loads it when a task matches its description.
Can I use Skill Health 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 ayutaz/piper-plus --skill skill-health -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-health, .gemini/skills/skill-health, .github/skills/skill-health and .opencode/skills/skill-health in your project.
What does Skill Health need to run?
Going by SKILL.md and its folder, Skill Health needs the command-line tools its instructions call (uv). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(uv run *), Bash(ls *), Bash(test *), Bash(file *), Bash(stat *), Read, Grep.
Does Skill Health access the network?
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Skill Health 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 Health use?
Skill Health 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 Health use?
About 626 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Skill Health?
Skills that share tags, products or a category with Skill Health: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Skill Health?
ayutaz (a GitHub user) maintains it in ayutaz/piper-plus, which has 234 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 10, 2026.
Source: ayutaz/piper-plus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.