cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html << 'HTMLEOF'

カスタム Skills エコシステム構築

チームが複数の Skill を蓄積した後、どのように統一して組織・管理・配布するかが、「プライベート Skill エコシステム」を構築するための核心的な問題です。


エコシステムの三つの階層

階層内容目標
Skill ライブラリすべての Skill を統一的に管理する Git リポジトリバージョン管理、追跡可能
配布メカニズム.skill パッケージファイルの保存と配布チャネルチームメンバーが迅速にインストールできるようにする
ドキュメントセンター各 Skill の使用方法、適用シーン学習コストを下げる

統一リポジトリ構造

すべてのチーム Skill を同じ Git リポジトリに置き、ディレクトリで異なる Skill を分離することを推奨します。

skills-repo/
├── README.md                  # 仓库总览,列出所有 Skill
├── .github/
│   └── workflows/
│       └── package.yml        # CI:自动打包 .skill 文件
├── skills/
│   ├── data-analyzer/         # Skill 1
│   │   ├── SKILL.md
│   │   └── scripts/
│   ├── doc-generator/         # Skill 2
│   │   ├── SKILL.md
│   │   └── scripts/
│   └── code-reviewer/         # Skill 3
│       ├── SKILL.md
│       └── scripts/
├── dist/                      # 打包好的 .skill 文件
│   ├── data-analyzer.skill
│   ├── doc-generator.skill
│   └── code-reviewer.skill
└── tools/
    └── build_all.sh           # 批量打包脚本

一括パッケージングスクリプト

例

#!/bin/bash
# ファイルパス:tools/build_all.sh
# すべての Skill を .skill ファイルにパッケージし、dist/ ディレクトリに出力する

set -e  # エラーが発生したらすぐに終了する

SKILLS_DIR="skills"
DIST_DIR="dist"
mkdir -p "$DIST_DIR"

echo "すべての Skill のパッケージングを開始..."

for skill_dir in "$SKILLS_DIR"/*/; do
    skill_name=$(basename "$skill_dir")
    echo "  パッケージング中:$skill_name"

    python -m scripts.package_skill "$skill_dir" \
      --output "$DIST_DIR/${skill_name}.skill"

    echo " 完了:$DIST_DIR/${skill_name}.skill"
done

echo ""
echo "すべてのパッケージングが完了しました。合計$(ls $DIST_DIR/*.skill | wc -l)個の Skill。"
开始打包所有 Skill...
  正在打包:data-analyzer
  完成:dist/data-analyzer.skill
  正在打包:doc-generator
  完成:dist/doc-generator.skill
  正在打包:code-reviewer
  完成:dist/code-reviewer.skill

全部打包完成,共 3 个 Skill。

GitHub Actions による自動パッケージング

メインブランチにコードをプッシュするたびに、すべての Skill を自動的にパッケージし、Release の添付ファイルとして公開します。

例

# ファイルパス:.github/workflows/package.yml
name
: Skills をパッケージして公開

on
:
  push
:
    branches
: [main]      # main ブランチへのプッシュ時にトリガー
  release
:
    types
: [created]       # Release 作成時にもトリガー

jobs
:
  build
:
    runs-on
: ubuntu-latest
    steps
:
      - name
: コードを取得
        uses
: actions/checkout@v4

      - name
: Python をインストール
        uses
: actions/setup-python@v5
        with
:
          python-version
: "3.11"

      - name
: パッケージングツールの依存関係をインストール
        run
: pip install -r tools/requirements.txt

      - name
: Skills を一括パッケージング
        run
: bash tools/build_all.sh

      - name
: .skill ファイルをビルド成果物としてアップロード
        uses
: actions/upload-artifact@v4
        with
:
          name
: skill-packages
          path
: dist/*.skill
          retention-days
: 30   # 30 日間保持

Skill レジストリ(Registry)

Skill の数が増えたら、JSON レジストリを使ってすべての Skill のメタ情報を管理し、検索や必要に応じたインストールを容易にします。

例

{
  "registry_version": "1.0",
  "updated_at": "2026-05-18",
  "skills": [
    {
      "name":        "data-analyzer",
      "version":     "1.2.0",
      "description": "Excel/CSV データを分析し、統計レポートを生成",
      "tags":        ["データ", "Excel", "CSV", "統計"],
      "file":        "dist/data-analyzer.skill",
      "requires":    ["python>=3.8", "pandas>=2.0"]
    },
    {
      "name":        "doc-generator",
      "version":     "2.0.1",
      "description": "テンプレートに基づいて Word/PDF ドキュメントを生成",
      "tags":        ["ドキュメント", "Word", "PDF", "テンプレート"],
      "file":        "dist/doc-generator.skill",
      "requires":    ["python>=3.8", "python-docx>=1.0"]
    }
  ]
}

チーム Skill 配布リスト

チームの新メンバー向けに Skill インストールリストを用意し、よく使う Skill をすぐに設定できるようにします。

# 团队 Skills 安装指南

## 必装 Skills(所有成员)

| Skill | 用途 | 下载地址 |
|-------|------|---------|
| data-analyzer | 数据分析与报表 | dist/data-analyzer.skill |
| doc-generator | 文档自动生成 | dist/doc-generator.skill |

## 按需安装

| Skill | 适合角色 | 下载地址 |
|-------|---------|---------|
| code-reviewer | 开发人员 | dist/code-reviewer.skill |

## 安装方式
1. 下载 .skill 文件
2. 在 Claude.ai 的 Settings → Skills 中上传文件
3. 安装完成后重新开始对话即可生效
その他の拡張