toraco claude-skills

toraco の共有 Claude Code skills を plugin marketplace として公開しているリポジトリ。

ローカルの Claude Code だけでなく、Claude Code Web / Cowork のクラウドセッションからも使えるようにするために public にしてある。クラウドセッションの GitHub アクセスは専用プロキシ経由で、セッションにアタッチされたリポジトリにしか到達できないため、private リポジトリを marketplace にするとクラウドから clone できない。

構成

claude-skills/
├── .claude-plugin/marketplace.json   # marketplace: toraco-skills
└── plugins/toraco/
    ├── .claude-plugin/plugin.json    # plugin: toraco
    └── skills/
        ├── _shared/                  # 複数 skill から参照する共通ドキュメント（skill としては発動しない）
        └── <skill-name>/SKILL.md

収録 skill

使い方

ローカル

claude plugin marketplace add toraco/claude-skills
claude plugin install toraco@toraco-skills

skill は /toraco:<skill-name> で起動する。

marketplace はローカルディレクトリではなく GitHub ソースで登録すること。 ディレクトリソースで登録すると plugin skill がスラッシュコマンドとして登録されない（anthropics/claude-code#57737）。

クラウドセッション（Claude Code Web / Cowork）

ユーザースコープの設定（~/.claude/settings.json や ~/.claude/skills/）はクラウドに引き継がれない。作業リポジトリ側で用意する必要がある。

.claude/settings.json（コミットする）:

{
  "extraKnownMarketplaces": {
    "toraco-skills": { "source": { "source": "github", "repo": "toraco/claude-skills" } }
  },
  "enabledPlugins": { "toraco@toraco-skills": true }
}

宣言だけではインストールが走らない場合があるため（初回セッションで marketplace の clone が session start に間に合わない既知の問題）、クラウド環境の Setup script にも冪等な導入コマンドを書いておくと確実。Setup script は Claude Code の起動前に実行される。

# --- toraco skills ---
# リポジトリの .claude/settings.json での宣言が session start に間に合わないことが
# あるための保険。ここが落ちてもセッションは起動させたいので、失敗は許容する。
# 環境のスナップショットは script を変更するまで再利用されるため、
# claude-skills の更新をすぐ反映したいときはこの日付を書き換えて再構築させる: 2026-10-01
set +e
claude plugin marketplace list | grep -q toraco-skills || \
  claude plugin marketplace add toraco/claude-skills
claude plugin list | grep -q "toraco@toraco-skills" || \
  claude plugin install toraco@toraco-skills
claude plugin marketplace update toraco-skills || true
claude plugin update toraco@toraco-skills || true
set -e

skill を追加・修正してもクラウドには自動で反映されない。 理由は 2 つある。

• 環境のスナップショットが再利用される。 Setup script の実行結果はスナップショットとして保存され、script の内容が変わるまで使い回される。その間は Setup script 自体が走らないため、plugin も更新されない。
• install だけでは更新されない。 plugin はインストール時のコミットで ~/.claude/plugins/cache/ に固定される。install は導入済みなら何もしないので、marketplace update / plugin update がないと再構築しても古い版が残ることがある。

そのため、この repo の変更をクラウドに反映したいときは Setup script 内のコメントの日付を書き換えて保存する（script が変わるのでスナップショットが作り直され、update で最新版が入る）。すぐに試したいだけなら、セッション内で update の 2 行を実行してから新しいセッションを開始してもよい（plugin update は再起動後に反映。ただしスナップショットには残らない）。

反映されたかは /toraco:<追加した skill> が補完に出るか、claude plugin list の版（コミット SHA）で確認する。

SKILL.md の規約

• frontmatter は Agent Skills spec の 6 キーに絞る: name / description / license / compatibility / metadata / allowed-tools。plugin 経由の配布では Claude Code 固有キー（argument-hint / disable-model-invocation など）も使えるが、claude.ai へのアップロード経路と共用できるよう spec に寄せてある。
  • 引数の説明は本文 H1 直後の **使い方**: /<name> [args] に書く。
  • 明示起動専用にしたい skill は description 末尾に「自動起動はせず、ユーザーが明示的に指示したときだけ使う。」と書く。
• description は 200 文字以内。skill 一覧は文字数予算があり、溢れると使用頻度の低い skill の description ごと落とされる。
• 同梱ファイルを参照するときは ${CLAUDE_SKILL_DIR} を使う。_shared/ は ${CLAUDE_SKILL_DIR}/../_shared/ で参照する。
• subagent のモデル指定: Agent ツールで model を指定する場合は、役割に応じて次のエイリアスを使う（エイリアスは常に各系統の最新モデルに解決される。バージョン付きのモデル ID は書かない）。
  • 設計・オーケストレーション（計画立案、複数 agent の結果の統合・判断など）: model: "opus"
  • 単純作業・実装（読解・抽出、scoring / 分類、コード修正など）: model: "sonnet"
  • haiku は使わない。

検証

claude plugin validate .
claude plugin marketplace add toraco/claude-skills && claude plugin install toraco@toraco-skills
claude plugin details toraco   # Skills (16) と出れば OK

{
  "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  "name": "toraco-skills",
  "description": "toraco の共有 Claude Code skills。ローカル・クラウドセッションの両方で使えるよう plugin marketplace として公開している",
  "owner": {
    "name": "toraco",
    "url": "https://github.com/toraco"
  },
  "plugins": [
    {
      "name": "toraco",
      "source": "./plugins/toraco",
      "category": "development"
    }
  ]
}