Agent skill

Precheck

by ayutaz in ayutaz/piper-plus

PR 作成前の lint + format + test 一括実行。引数で scope (python/rust/cs/go/js/cpp/all) を指定可能。未指定なら git diff から自動判定。

MITAuto-check passedDevelopment

Install Precheck

skills CLI
$ npx skills add ayutaz/piper-plus --skill precheck -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ayutaz/piper-plus precheck --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ayutaz/piper-plus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/precheck .claude/skills/precheck && rm -rf skills-src

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

Facts

Skill name
precheck
GitHub stars
220
Token cost
~647 tokens
SKILL.md length
110 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

PR 作成前の lint + format + test 一括実行。引数で scope (python/rust/cs/go/js/cpp/all) を指定可能。未指定なら git diff から自動判定。

  • Tasks that involve Linting and formatting
  • SKILL.md covers 変更ファイル, スコープ判定, 実行ステップ (該当スコープのみ) and 報告フォーマット, plus 2 more sections
  • Calls uv, dotnet and cargo

What it does

Precheck is an agent skill from ayutaz/piper-plus. PR 作成前の lint + format + test 一括実行。引数で scope (python/rust/cs/go/js/cpp/all) を指定可能。未指定なら git diff から自動判定。

Its SKILL.md is about 650 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, covering Linting and formatting. It works with Python, C++, Rust and Git. 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

  • Tasks that involve Linting and formatting

Example prompts

  • “/precheck”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(uv run *), Bash(cargo *), Bash(dotnet *), Bash(go test *), Bash(go vet *), Bash(node *), Bash(npm *), Bash(cmake *), Bash(ctest *), Bash(git diff *), Bash(git status *)

What it can do on your machine

Read from SKILL.md and the folder at commit 9c6946e. 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(cargo *)
    • Bash(dotnet *)
    • Bash(go test *)
    • Bash(go vet *)
    • Bash(node *)
    • Bash(npm *)
    • Bash(cmake *)
    • Bash(ctest *)
    • Bash(git diff *)

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • dotnet
    • cargo
    • go
    • git
    • npm
    • cmake

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, git and npm, 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

Precheck loads about 647 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 110 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~647

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 9c6946e, republished under its MIT licence (© ayutaz). 110 words, ~647 tokens.

Download SKILL.mdSave it as .claude/skills/precheck/SKILL.md (or your agent's skills folder).
name
precheck
description
PR 作成前の lint + format + test 一括実行。引数で scope (python/rust/cs/go/js/cpp/all) を指定可能。未指定なら git diff から自動判定。
allowed-tools
Bash(uv run *), Bash(cargo *), Bash(dotnet *), Bash(go test *), Bash(go vet *), Bash(node *), Bash(npm *), Bash(cmake *), Bash(ctest *), Bash(git diff *), Bash(git status *)
argument-hint
[python|rust|cs|go|js|cpp|all]
disable-model-invocation
true

Pre-commit / Pre-PR チェック

$ARGUMENTS で指定されたスコープに対して、CI が実行するチェックと同等の検査をローカルで実行します。

変更ファイル

!git diff --name-only HEAD 2>/dev/null | head -30

スコープ判定

引数 $ARGUMENTS:

  • python → src/python/ + src/python_run/ のみ
  • rust → src/rust/ のみ
  • cs → src/csharp/ のみ
  • go → src/go/ のみ
  • js → src/wasm/openjtalk-web/ のみ
  • cpp → src/cpp/ のみ
  • all → 全ランタイム
  • (空) → 上記の git diff の結果からスコープを推定 (複数該当ならそれら全て)

実行ステップ (該当スコープのみ)

Python
bash
# Lint
uv run ruff check src/python_run/ src/python/

# Format check
uv run ruff format --check src/python_run/ src/python/

# Unit tests (runtime + g2p)
cd src/python_run && uv run pytest tests/ -o addopts="" --tb=short -q && cd ../..
Rust
bash
cd src/rust
cargo fmt --all -- --check
cargo clippy --workspace --all-features -- -D warnings
cargo test -p piper-plus --no-fail-fast
cd ../..
C# (.NET)
bash
dotnet build src/csharp/PiperPlus.sln -c Release --nologo
dotnet format src/csharp/PiperPlus.sln --verify-no-changes --no-restore
dotnet test src/csharp/PiperPlus.sln -c Release --no-build --nologo --verbosity minimal
Go
bash
cd src/go
go vet ./... ./phonemize/...
go test -race -count=1 ./... ./phonemize/...
cd ../..
JavaScript / WASM
bash
cd src/wasm/openjtalk-web
npm run test:npm-package:all
cd ../../..
C++
bash
cmake --build build --config Release
ctest --test-dir build -C Release --output-on-failure

報告フォーマット

各ステップ完了後、以下の形式で結果を報告:

text
## Precheck 結果

| ステップ | 結果 | 詳細 |
|---------|------|------|
| Python ruff check | ✅ / ❌ | (失敗時はエラー要約) |
| Python ruff format | ✅ / ❌ | |
| Python pytest | ✅ / ❌ | (passed/failed/skipped カウント) |
| ... | ... | ... |

失敗時の対応

  • ruff format 失敗 → uv run ruff format src/python_run/ src/python/ で自動修正
  • ruff check 失敗 → uv run ruff check --fix src/python_run/ src/python/ で自動修正
  • pytest 失敗 → 失敗テストの最初の 3 件を要約して原因候補を提示
  • dotnet format 失敗 → dotnet format src/csharp/PiperPlus.sln で自動修正

注意

  • pytest.ini に --cov が含まれていて pytest-cov が無い環境では -o addopts="" で上書きする (CLAUDE.md memory)
  • 学習ジョブや巨大ベンチマークは実行しない (unit/integration のみ)
  • 1 ステップでも失敗したら以降のステップは実行せず即報告 (set -e 相当)

© 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/precheck of ayutaz/piper-plus.

Open the folder on GitHubat commit 9c6946e

Compare with similar skills

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

Precheck compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Precheck this skillayutaz/piper-plus220—~647Automated safety check: PassMIT
Git HooksProrise-cool/Claude-Code-Multi-Agent305—~3.6kAutomated safety check: NotesNone
Tilelang Reviewtile-ai/tilelang-ascend400—~2.8kAutomated safety check: NotesMIT
Implement From Planbesimple-oss/broccoli286—~406Automated safety check: PassMIT
Check Toolsoaustegard/claude-skills150—~641Automated safety check: PassMIT
Core API Changelibnativeapi/nativeapi161—~2.5kAutomated safety check: PassMIT

Similar skills

  • Git Hooks

    Prorise-cool/Claude-Code-Multi-Agent

    Central authority on git hook implementations, modern best practices, and tooling for .NET/C, JavaScript/TypeScript, Python, and polyglot repositories.

    305 GitHub stars~3.6k tokensUpdated 22 days ago
    DevelopmentAuto-check: notes
  • Tilelang Review

    tile-ai/tilelang-ascend

    检查代码格式是否符合 CI 规则。自动检测并安装缺失工具(ruff、clang-format),先运行检查生成报告,使用醒目方式询问用户后,仅在用户同意时执行修复。工作流程:检测环境→自动安装缺失工具→运行检查→生成报告→醒目询问→用户确认→执行修复。使用此技能当:用户要求"格式检查"、"格式化代码"、"代码格式化"、"检查代码格式"、"代码…

    400 GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check: notes
  • Implement From Plan

    besimple-oss/broccoli

    Implement an approved plan doc step-by-step in application or systems codebases, including Node/TS, Python, and C/C++ repos (build/lint/test per step, atomic commits, progress log hygiene).

    286 GitHub stars~406 tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Check Tools

    oaustegard/claude-skills

    Validates development tool installations across Python, Node.js, Java, Go, Rust, C/C++, Git, and system utilities.

    150 GitHub stars~641 tokensUpdated today
    DevelopmentAuto-check passed
  • Core API Change

    libnativeapi/nativeapi

    Carry a change to the C++ public API in core/ all the way downstream — design check, header edit, six platform implementations, C ABI + Rust/Dart/C/JS/Python regeneration, per-binding verification…

    161 GitHub stars~2.5k tokensUpdated today
    MobileAuto-check passed
  • Official

    Statically pairs source files with test files to list code that no test references, using Roslyn for C# or tree-sitter for many languages, with no build.

    5.6k GitHub starsUsed in 1 repo~3.3k tokens
    Testing & QAAuto-check passed

More from ayutaz/piper-plus

All 20 skills in this repo
  • Skill Health

    ayutaz/piper-plus

    .claude/skills//SKILL.md の frontmatter / referenced script 実在 / trigger 衝突 / .claude/hooks/.sh の executable+shebang を検査する meta-skill。

    220 GitHub stars~626 tokensUpdated today
    Auto-check passed
  • Bump Deps

    ayutaz/piper-plus

    ORT / openjtalk / ruff のような cross-runtime に canonical sync が必要な依存関係を 1 コマンドで bump する read-mostly skill。

    220 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • 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 ランタイム +…

    220 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • 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…

    220 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • 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 の更新漏れを…

    220 GitHub stars~964 tokensUpdated today
    Auto-check passed
  • Check PR Ready

    ayutaz/piper-plus

    PR 作成前の最終チェックリスト (lint/test/docs/CHANGELOG/未コミット確認)。/precheck の拡張版で、ドキュメント整合性も検証します。

    220 GitHub stars~687 tokensUpdated today
    Auto-check passed

Categories

Questions about Precheck

What does Precheck do?

PR 作成前の lint + format + test 一括実行。引数で scope (python/rust/cs/go/js/cpp/all) を指定可能。未指定なら git diff から自動判定。. Precheck is an agent skill from ayutaz/piper-plus.

When should I use Precheck?

Precheck fits situations like: tasks that involve Linting and formatting.

How do I install Precheck in Claude Code?

Run `npx skills add ayutaz/piper-plus --skill precheck -a claude-code`. Or copy the skill folder (.claude/skills/precheck in ayutaz/piper-plus) into .claude/skills/precheck in your project. Claude Code loads it when a task matches its description.

How do I install Precheck in Codex?

Run `npx skills add ayutaz/piper-plus --skill precheck -a codex`. Or copy the skill folder (.claude/skills/precheck in ayutaz/piper-plus) into .agents/skills/precheck in your project. Codex loads it when a task matches its description.

Can I use Precheck 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 precheck -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/precheck, .gemini/skills/precheck, .github/skills/precheck and .opencode/skills/precheck in your project.

What does Precheck need to run?

Going by SKILL.md and its folder, Precheck needs the command-line tools its instructions call (uv, dotnet, cargo, go, git and npm). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(uv run *), Bash(cargo *), Bash(dotnet *), Bash(go test *), Bash(go vet *), Bash(node *), Bash(npm *), Bash(cmake *), Bash(ctest *), Bash(git diff *), Bash(git status *).

Does Precheck access the network?

SKILL.md contains no URLs. Its commands use uv, git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Precheck 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 Precheck use?

Precheck 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 Precheck use?

About 647 tokens (SKILL.md is roughly 2.6k 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 Precheck?

Skills that share tags, products or a category with Precheck: Git Hooks (Prorise-cool/Claude-Code-Multi-Agent, 305 stars), Tilelang Review (tile-ai/tilelang-ascend, 400 stars), Implement From Plan (besimple-oss/broccoli, 286 stars) and Check Tools (oaustegard/claude-skills, 150 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Precheck?

ayutaz (a GitHub user) maintains it in ayutaz/piper-plus, which has 220 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 8, 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.