commit

A guided process for reviewing and creating commits in the piper-plus codebase, including checking the branch, changed files, and commit rules.

In plain words
What is it for?
Use it before committing changes to inspect the current state, review the diff, check whether documentation should be updated, and follow repository-specific rules.
Why use it?
It reduces the risk of committing on the wrong branch or accidentally including secrets such as environment files, keys, or certificates.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ayutaz/piper-plus/commit
Any agent
npx skills add ayutaz/piper-plus --skill commit
Clone the repo
git clone --depth 1 https://github.com/ayutaz/piper-plus

Made for: Claude Code, Codex.

Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,728 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00053 $0.01728
Opus 5 $0.00026 $0.00864
Sonnet 5 $0.00011 $0.00346
Haiku 4.5 $0.00005 $0.00173

Measured 2d ago against content hash ce9c664697cf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

commit scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/commit/SKILL.md · 143 lines

How it starts

The opening of the file, as written. The whole thing — 143 lines — stays where its author put it; the contents beside it link to each section on GitHub.

piper-plus 向けコミット

CLAUDE.md のコミット規約に従い、ステージ済みまたは指定ファイルを安全にコミットします。

現在の状態

  • ブランチ: !git rev-parse --abbrev-ref HEAD
  • 直近のコミット: !git log -3 --oneline
  • ステージ状態: !git status --short
  • 差分サマリ: !git diff --stat HEAD

手順

💡 大規模変更の場合: /sync-docs を先に呼び出してドキュメント整合性を確認することを推奨します。このスキルはステップ 2.5 でその判定を行います。

1. ブランチ確認

現在のブランチを確認し、dev の場合はユーザーに確認を取る (CLAUDE.md: 通常はフィーチャーブランチで作業)。

2. 変更内容の把握

  • git status --short で変更ファイルを確認
  • git diff で内容を簡単にレビュー
  • .env, .env.*, credentials*, *.pem, *.key 等の秘密情報が含まれていないか 必ず チェック
  • 含まれていたら 即中止 してユーザーに報告

2.5. ドキュメント同期チェック

コード変更のサイズと種類に応じて、ドキュメント更新が必要か判定します。

判定基準

以下のいずれかに該当する場合、/sync-docs skill を呼び出すことを強く推奨:

  • git diff --stat の変更行数が 100 行以上
  • src/python_run/piper_plus/ / src/python/g2p/ / src/rust/piper-core/ / src/cpp/ / src/csharp/ / src/go/ / src/wasm/openjtalk-web/src/ に新規ファイルが追加されている
  • 公開 API (関数シグネチャ、クラス、メソッド、HTTP エンドポイント) に変更がある
  • piper_train / timing / voice / phonemize / config などのコアモジュールが変更されている
  • 新規テストファイル (tests/test_*.py, test/js/test-*.js, etc.) が 3 つ以上追加されている
アクション
  1. 大規模/コア変更 → ユーザーに /sync-docs の実行を促す:

    このコミットには X 件のコア変更が含まれます。/sync-docs でドキュメント整合性を監査してからコミットしますか?

  2. 小規模変更 (< 100 行、ドキュメントのみ、テストのみ、バグ修正) → スキップ可

  3. ユーザーが「スキップ」を選択 → 警告のみ表示して続行

このステップは informational です。ユーザーが明示的にスキップを選べば、コミット自体はブロックしません。

3. ファイルのステージング

  • ユーザーが既にステージしている場合はそのまま使用
  • 必要なら関連ファイルだけを git add <file1> <file2> で個別追加
  • git add -A / git add . は禁止 (誤って秘密情報をステージするリスク)

4. コミットメッセージ生成

$ARGUMENTS がある場合はそれを優先。なければ変更内容から自動生成:

Prefix 規約
Prefix 用途
feat(<scope>): 新機能 (scope = python/rust/cpp/cs/go/wasm/ci/docs)
fix(<scope>): バグ修正
refactor(<scope>): リファクタ (機能変更なし)
docs: ドキュメントのみ
test: テスト追加・修正
chore(<scope>): ビルド/依存/雑務
perf(<scope>): パフォーマンス改善
メッセージ本文の規約
  • 1-2 文、why を強調
  • 日本語可
  • 命令形ではなく事実の記述 ("Add X" ではなく "X を追加")
  • 詳細は本文に bullet で記述 (短いタイトルだけでなく)

Read the full file on GitHub · 143 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 143 lines · 53 tokens per session scan A ce9c664697cf

Subscribe to this mod's changes

commit is a skill published in the GitHub repository ayutaz/piper-plus (202 stars, last pushed 4d ago), licensed MIT. It adds 53 tokens to every session and 1,728 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

model-integration

Use when adding a new model or pipeline to diffusers, setting up file structure for a new model, converting a pipeline to modular format, or converting weights for a new version of an already-supported model.

huggingface/diffusers · 45 tokens

custom-blocks

Use when the user has written (or wants to write) a ModularPipelineBlocks subclass in a local Python file and needs to package it into a Hub-uploadable directory. Covers the workflow from a single block.py file to a published custom-block repo that consumers can load via ModularPipeline.frompretrained( …

huggingface/diffusers · 79 tokens

diffusers-cli

Use when the user wants to run a diffusers pipeline from a terminal (one-off generation, batch jobs, smoke-testing a new model), run on HF Sandbox hardware via --remote, introspect a pipeline's input schema before calling it, or attach a LoRA at inference time. Prefer this over writing ad-hoc Python scripts for…

huggingface/diffusers · 75 tokens

self-review

Use before opening a PR, or whenever asked to self-review a diffusers contribution. Applies the same rubric as the @claude CI (checks the diff against references/review-rules.md, traces call paths for dead code). Reports findings grouped by severity, flagging what to fix before submitting (blocking issues + dead code)…

huggingface/diffusers · 88 tokens

hf-release-notes

Generate Hugging Face Hub (huggingfacehub) release notes from cached PR JSON files. Use when asked to draft release notes from PR files.

huggingface/huggingface_hub · 36 tokens

physicsnemo-shard-tensor

Official NVIDIA-authored guidance for PhysicsNeMo ShardTensor domain parallelism — integrate domain parallelism into training/inference scripts (new or existing) with DDP or FSDP2, write and register shard patches to enable new layers/ops, and bootstrap multi-GPU correctness tests. Use when working with ShardTensor…

NVIDIA/physicsnemo · 152 tokens