skill-forge-publish

スキルの公開と配布

プロセス

ステップ 1：公開前の検証

公開前にレビューをすべて実施します。

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

ステップ 2：インストールスクリプトを作成する

以下を処理する install.sh を生成します。

#!/usr/bin/env bash
# Install script for [skill-name]
# Usage: 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 "Installing [skill-name] skill..."

# Create directories
mkdir -p "$SKILL_DIR" "$AGENT_DIR"

# Copy main skill
cp -r "$SCRIPT_DIR/skill-name" "$SKILL_DIR/"
echo "  Installed: skill-name"

# Copy sub-skills
for skill in "$SCRIPT_DIR/skills"/skill-name-*/; do
    if [ -d "$skill" ]; then
        skill_basename=$(basename "$skill")
        cp -r "$skill" "$SKILL_DIR/"
        echo "  Installed: $skill_basename"
    fi
done

# Copy agents (if any)
if [ -d "$SCRIPT_DIR/agents" ]; then
    cp "$SCRIPT_DIR/agents"/*.md "$AGENT_DIR/" 2>/dev/null || true
    echo "  Installed agents"
fi

echo ""
echo "Installation complete!"
echo "Test with: /skill-name"

ステップ 3：README.md を作成する（スキルフォルダー内ではなく、リポジトリレベル）

# [Skill Name]

[1-2 sentence description focusing on outcomes, not features]

## What it does

[Bullet list of key capabilities]

## Installation

### Claude Code

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

### Claude.ai
1. Download the latest release (.zip)
2. Go to Settings > Capabilities > Skills
3. Click "Upload skill"
4. Select the downloaded .zip file

## Commands

| Command | Description |
|---------|-------------|
| `/skill-name` | [description] |
| `/skill-name cmd` | [description] |

## Examples

### [Example 1 title]

ユーザー：「[example input]」

[Description of what happens and expected output]

## Architecture

[ファイルツリー図]

## License

[License type]

ステップ 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 Plugin Marketplace	幅広い配布	.claude-plugin/ マニフェスト