Skills の公開とチーム共有

開発が完了した Skill は、パッケージ化、テスト、ドキュメント化を経て、チームメンバーに配布したり公開したりすることができます。

この記事では、開発完了からリリースまでの完全な流れを紹介します。

公開前のチェックリスト

公開前に項目ごとに確認し、未完成または欠陥のある Skill を配布しないようにします。

確認項目確認内容参照章
機能が完全計画されたすべての機能が実装され、テスト済みであること第22篇
エラー処理一般的なエラーシナリオにはすべて処理とヒントがあること第16篇
Description が正確トリガーテストの合格率 ≥ 85%第24篇
依存関係が宣言されているrequirements.txt または compatibility フィールドが完全であること第20篇
ハードコードされたキーがないスクリプト内に API キー、パスワードなどの機密情報がないこと第28篇
バージョン番号が更新されているSKILL.md の version フィールドが更新されていること第21篇
CHANGELOG が更新されている今回の変更が記録されていること第21篇
デバッグコードが除去されている一時的な print、デバッグ用チェックポイント、TODO がないこと第23篇

.skill ファイルにパッケージ化

公開前に Skill ディレクトリをパッケージ化して、.skillファイルにする必要があります。これは配布可能な標準形式です。

例

# 基本的なパッケージ化コマンド
python -m scripts.package_skill my-skill/

# 出力パスとバージョン番号を指定
python -m scripts.package_skill my-skill/ \
  --output dist/my-skill-v1.2.0.skill \
  --version 1.2.0

# パッケージ化後にファイルが完全かどうか検証する（パッケージ内のファイルを一覧表示）
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
打包完成：dist/my-skill-v1.2.0.skill（共 8 个文件，42KB）
包含：
  SKILL.md
  scripts/process.py
  scripts/requirements.txt
  assets/template.xlsx

ユーザードキュメントの作成

SKILL.md の末尾または独立した README.md に、完全なユーザー説明を記載します。

# 数据分析助手 v1.2.0

## 这个 Skill 能做什么

上传 CSV 或 Excel 文件后，自动完成以下工作：
- 统计各列的行数、均值、最大/最小值、空值比例
- 生成数据质量报告，标注需要清理的问题列
- 输出带统计图表的 Excel 报告文件

## 快速开始

1. 在对话中上传你的数据文件（.csv 或 .xlsx）
2. 说："帮我分析这份数据" 或 "生成统计报告"
3. 等待分析完成，下载生成的 Excel 报告

## 系统要求

- Python 3.8+
- pandas >= 2.0（首次运行时自动安装）

## 常见问题

**Q：文件太大怎么办？**
建议文件不超过 50MB。更大的文件请先筛选或抽样后上传。

**Q：支持哪些编码？**
支持 UTF-8 和 GBK。若文件乱码，请另存为 UTF-8 后重新上传。

配布チャネル

チャネル適用シナリオ操作方法
ファイルを直接送信小規模チーム内での共有.skill ファイルを送信し、相手が Claude にアップロードする
Git リポジトリチームでの共同作業、バージョン管理が必要プライベート/公開リポジトリにコミットし、dist/ からダウンロードする
GitHub Releases正式リリース、公開共有Release を作成し、.skill ファイルを添付する
内部 CI/CD企業内部の自動配布CI がパッケージ化した後、内部ファイルサーバーにプッシュする

GitHub Releases による公開

例

# Git タグを作成してプッシュ
git tag v1.2.0 -m "v1.2.0 をリリース：チャート生成機能を追加"
git push origin v1.2.0

# GitHub CLI で Release を作成し、.skill ファイルを添付する
gh release create v1.2.0 \
  dist/my-skill-v1.2.0.skill \
  --title "My Skill v1.2.0" \
  --notes "チャート生成機能を追加、大容量ファイル処理のメモリ問題を修正"

インストール手順ページのテンプレート

もしあなたの Skill が複数人での使用を想定しているなら、インストール手順について簡潔なガイドを別途作成できます。

## 安装方法

1. 前往 [Release 页面](https://github.com/yourname/skills/releases/latest)
2. 下载 `my-skill-v1.2.0.skill` 文件
3. 打开 Claude.ai → Settings（设置）→ Skills
4. 点击"上传 Skill"，选择下载的 .skill 文件
5. 安装完成后，开始新对话即可使用

安装后，在对话中发送以下内容可以验证安装成功：

> "我上传了一个 CSV 文件，请帮我做数据统计分析"

若 Skill 正常工作，Claude 会按照 Skill 的流程引导你完成分析。
その他の拡張