スキル公開・配布

スキル公開・配布 は何をしますか？

プロセス

ステップ1: 公開前のバリデーション

公開前に完全なレビューを実行します:

1. /skill-forge review <path> を実行し、スコアが80/100以上であることを確認する
2. クリティカルまたは優先度の高い問題を修正する
3. 少なくとも5つのトリガークエリでテストする
4. すべての相互参照が解決されていることを確認する

ステップ2: インストールスクリプトの作成

以下の処理を行う install.sh を生成します:

#!/usr/bin/env bash
# [スキル名] のインストールスクリプト
# 使い方: bash install.sh

set -euo pipefail

SKILL_DIR="$HOME/.claude/skills"
AGENT_DIR="$HOME/.claude/agents"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

echo "[スキル名] スキルをインストールしています..."

# ディレクトリを作成
mkdir -p "$SKILL_DIR" "$AGENT_DIR"

# メインスキルをコピー
cp -r "$SCRIPT_DIR/skill-name" "$SKILL_DIR/"
echo "  インストール完了: skill-name"

# サブスキルをコピー
for skill in "$SCRIPT_DIR/skills"/skill-name-*/; do
    if [ -d "$skill" ]; then
        skill_basename=$(basename "$skill")
        cp -r "$skill" "$SKILL_DIR/"
        echo "  インストール完了: $skill_basename"
    fi
done

# エージェント（存在する場合）をコピー
if [ -d "$SCRIPT_DIR/agents" ]; then
    cp "$SCRIPT_DIR/agents"/*.md "$AGENT_DIR/" 2>/dev/null || true
    echo "  エージェントをインストールしました"
fi

echo ""
echo "インストールが完了しました！"
echo "テスト方法: /skill-name"

ステップ3: README.mdの作成（リポジトリルート。スキルフォルダ内には置かない）

# [スキル名]

[成果に焦点を当てた1〜2文の説明]

## できること

[主な機能の箇条書きリスト]

## インストール

### Claude Code

git clone https://github.com/[user]/[repo] cd [repo] bash install.sh

### Claude.ai
1. 最新リリース(.zip)をダウンロード
2. Settings > Capabilities > Skillsに移動
3. 「Upload skill」をクリック
4. ダウンロードした.zipファイルを選択

## コマンド

| コマンド | 説明 |
|---------|------|
| `/skill-name` | [説明] |
| `/skill-name cmd` | [説明] |

## 使用例

### [使用例1のタイトル]

ユーザー: "[入力例]"

[何が起こるかと期待される出力の説明]

## アーキテクチャ

[ファイルツリー図]

## ライセンス

[ライセンス種別]

ステップ4: 配布用パッケージ化

Claude.aiアップロード用: python scripts/package_skill.py <path> <output-dir> を実行して .skill zipファイルを作成します。

GitHub用:

1. リポジトリを作成し、ルートにREADME.mdを配置
2. スキルフォルダをルートレベルに配置
3. install.shをルートレベルに配置
4. LICENSEファイルを追加
5. .gitignoreを追加（.tmp/、pycache/、*.pyc を除外）

チームデプロイメント用（Claude.ai管理者）:

• 管理者がワークスペース全体にスキルをデプロイできます
• .skill zipとしてパッケージ化し、管理コンソールからアップロードします

ステップ5: .gitignoreの作成

__pycache__/
*.pyc
*.pyo
.tmp/
*.egg-info/
dist/
build/
.env
*.skill

ステップ6: リリースチェックリスト

• すべてのファイルがバリデーション済み（スコア >= 80）
• install.shがクリーンなシステムでテスト済み
• README.mdにインストール、使用方法、使用例が記載されている
• LICENSEファイルが含まれている
• .gitignoreが設定されている
• シークレットやAPIキーがどのファイルにも含まれていない
• テストクエリが文書化されている
• バージョンタグが打たれている（gitを使用している場合）

ステップ7: 公開後

公開後:

1. クリーンな環境でゼロからインストールをテストする
2. すべてのトリガーテストクエリを実行する
3. 初期ユーザーフィードバックを収集する
4. フィードバックに基づいて最初のイテレーションを計画する
5. バグレポート用のIssueテンプレートを設定する

配布チャネル

チャネル	最適な用途	形式
GitHub	オープンソース、コミュニティ	リポジトリ + install.sh
Claude.aiアップロード	個人利用	.skill zip
チーム管理者	組織全体	管理コンソール経由の .skill zip
Claudeプラグインマーケットプレイス	広範な配布	.claude-plugin/ マニフェスト