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。"
# ファイルパス: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 日間保持
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"]
}
]
}
"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. 安装完成后重新开始对话即可生效その他の拡張