Skills Github Publisher

Skills GitHub Publisher

Overview

Claude Code skills を GNU Stow で管理されている GitHub リポジトリに追加し、公開するワークフローを提供する。スキルの内容確認、セキュリティチェック、README 作成、git 操作を順次実行する。

スキルは GNU Stow により ~/.claude/skills/ にシンボリックリンクとして配置されている。シンボリックリンクを辿ることで、Stow パッケージ（git リポジトリ）内のファイル実体にアクセスできる。

Workflow

Step 1: スキル名の確認と Stow チェック

ユーザーからスキル名を受け取る。スキル名が明示されていない場合は、未公開スキルの一覧を提示して選択してもらう。

未公開スキルの判定方法:

~/.claude/skills/ 配下のディレクトリの種別で判定する：

• シンボリックリンク → Stow パッケージ内にある → 公開済み
• 実体ディレクトリ → ローカルのみ → 未公開（公開候補）

# 実体ディレクトリ（未公開スキル）を列挙
ls -la ~/.claude/skills/ | grep "^d"

未公開スキルが見つかった場合、各スキルの SKILL.md の description を読み取り一覧として提示する。その際、Step 3 の公開チェック基準に基づいて簡易セキュリティチェックも行い、明らかに公開不可なスキルにはその旨を注記する。

Step 2: スキル内容の確認

スキルディレクトリ配下のすべてのファイルを確認し、主要ファイルを読み込む：

• SKILL.md: スキルの説明とワークフロー
• references/: リファレンスファイル（存在する場合）
• その他の重要ファイル

Step 3: 公開チェック

確認した内容から、以下をチェック：

✅ 公開可能な内容:

• 一般的なワークフローやテンプレート
• 公開 API の使い方
• OSS/ツールの調査方法
• 技術的なドキュメント

❌ 公開不可な内容:

• 機密情報（API キー、トークン、パスワード）
• 個人情報（メールアドレス、電話番号、住所）
• プライベートな設定（個人のパス、認証情報）
• 企業の機密データ
• ユーザー固有の情報（固定のリポジトリ URL、ユーザー名を含むパス、個人の設定値）

チェック結果をユーザーに報告：

✅ 公開可能
❌ 公開不可（理由を明記）

公開不可の場合はワークフローを中断。

Step 4: Stow パッケージへのコピー

スキルが実体ディレクトリ（未公開）の場合、Stow パッケージにコピーする。

移動先は、~/.claude/skills/ 配下にある既存シンボリックリンクのリンク先の親ディレクトリとする。mv コマンドで移動し、stow を再適用してシンボリックリンクを作成する。

既にシンボリックリンク（公開済み）の場合はこのステップをスキップする。

Step 5: スキル README.md の作成

スキルディレクトリ内に README.md を作成。コンパクトな形式で以下を含める：

# 

## 機能

- 機能 1
- 機能 2
- 機能 3

## 使い方

\`\`\`

\`\`\`

## 出力

## 技術詳細

- [リファレンス 1](references/xxx.md)（存在する場合）

重要: 詳細は省き、コンパクトにまとめる。

Step 6: ルート README.md の更新

リポジトリルートの README.md にあるテーブルに行を追加する。既存テーブルのリンク形式に合わせる：

| [](claude-code-skills/.claude/skills//) |  |

Step 7: git 操作（add, commit）

変更対象ファイルを個別に指定してステージング、コミット：

# ステージング（個別ファイル指定）
git add claude-code-skills/.claude/skills//
git add README.md
git status --short

# コミット
git commit -m "$(cat を追加

- 機能1
- 機能2
- 機能3

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.6 
EOF
)"

Step 8: 完了報告とプッシュ確認

gh コマンドでリポジトリ URL を取得し、ユーザーに以下を報告：

gh repo view --json url -q .url

• 公開チェック結果
• 追加されたファイル一覧
• コミットハッシュ
• スキルの公開 URL（プッシュ後）: /tree/main/claude-code-skills/.claude/skills/

報告後、ユーザーの確認を待ってから git push を実行する。自動的にプッシュしない。

Notes

• セキュリティチェックは必須。疑わしい内容がある場合は公開を中断
• README.md は簡潔に。詳細は SKILL.md に記載されているため重複を避ける
• git 操作の前に必ず git status で確認
• コミットメッセージは統一された形式を使用
• git add -f は使用禁止。.gitignore でブロックされる場合は .gitignore を修正して対応すること

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: taktamur
• Source: taktamur/claude-code-skills
• License: CC0-1.0

Install and usage instructions live in the source repository linked above.