GYOSUI SkillMarket

gyosui-submit

検証済みv1.0.0

自作スキルを GYOSUI SkillMarket(AZ-ONE-GROUP/gyosui-skillmarket)へ投稿する。SKILL.md の検証 → 機密セルフチェック → registry エントリ生成 → ブランチ作成 → PR 提出までを自動で行う。 トリガー: 「スキルマーケットに上げて」「スキルマーケットに投稿して」「このスキルを共有して」「gyosui-submit」。 対象: SKILL.md を含むスキルディレクトリ(Claude Code スキル・GAS・自動化スクリプト等)。 NOT for: 公開可否の最終判定(レビュアーの publish-check の役割)、サイト自体の開発・デプロイ。

ZIPダウンロード

gyosui-submit — GYOSUI SkillMarket へのスキル投稿

メンバーが「上げたいスキル」を指定するだけで、PR 提出まで完了させる。 このスキルは PR を出すところまで。公開されるのはレビュアーのチェックが通ってから(即公開ではない)。

前提の確認(最初に必ず)

  1. gh auth status — GitHub CLI が認証済みか。未認証なら gh auth login をユーザーに案内して中断
  2. 対象スキルのパス — 引数で受け取る。なければ「どのスキルを上げますか?(パス)」と質問。ディレクトリ直下に SKILL.md が無ければ中断して案内

手順

1. SKILL.md の検証

frontmatter から name / description / version を読む。

  • name が無ければディレクトリ名を slug として提案
  • slug は半角英数とハイフンのみ。既存スキルと重複しないか repo の registry.json を見て確認(重複時はリネーム提案)
  • description(1行説明・200字以内)が無ければユーザーに書いてもらう。version が無ければ 0.1.0 を提案

2. 機密セルフチェック(必須)

bash <このスキルのディレクトリ>/scripts/precheck.sh <対象ディレクトリ>
  • ヒットしたら一覧を見せて、各ヒットを本文を読んで判断(例示用のダミーなら OK、実物なら修正を求める)
  • 併せて自分の目でも確認: 取引先名・社内URL・実名・業務フローの詳細。機械検出ゼロ=安全ではない
  • 明確な機密が残っている間は先に進まない(修正 → 再チェック)
  • サイトは一般公開である旨を必ずユーザーに一言伝える

3. 投稿情報のヒアリング(1回でまとめて質問)

  • カテゴリ(1つ): 自動化 / リサーチ / ドキュメント / コミュニケーション / 分析・可視化 / 開発・運用
  • 対応ツール(1つ以上): Claude Code / GAS / Notion / Chatwork / Slack / Playwright / Zoom / Drive / Sheets / Gmail
  • タグ(任意・最大10)
  • アイコン(1つ): Mail / Search / NotebookPen / Table2 / FolderTree / Bell / TrendingUp / ClipboardList / Languages / TextCursorInput / Gauge / ReceiptText / Zap / FileText / MessageCircle / BarChart3 / Wrench / Boxes
  • 投稿者: handle(GitHubユーザー名など公開可の名前)と displayName。実名は不可(一般公開のため)

4. registry エントリの生成

{
  "slug": "<slug>",
  "path": "skills/<slug>",
  "author": { "handle": "<handle>", "displayName": "<displayName>" },
  "category": "<カテゴリ>",
  "tools": ["..."],
  "tags": ["..."],
  "icon": "<アイコン>",
  "verified": "none",
  "dependencies": ["<環境変数・前提があれば>"],
  "accessScope": ["<何を読み書きするか>"],
  "addedAt": "<今日 YYYY-MM-DD>"
}

publishCheck フィールドは絶対に書かない(レビュアーがチェック後に追記する。書いても審査は免除されない)。

5. ブランチ作成 → PR 提出

作業は一時ディレクトリで行う(ユーザーのスキルディレクトリは触らない):

gh repo clone AZ-ONE-GROUP/gyosui-skillmarket <tmpdir> -- --depth 1
cd <tmpdir>
git switch -c add-skill-<slug>
mkdir -p skills/<slug>
# スキル一式をコピー(.env* / credentials* / node_modules / .git は除外)
rsync -a --exclude '.env*' --exclude 'credentials*' --exclude 'node_modules' --exclude '.git' <対象ディレクトリ>/ skills/<slug>/
# registry.json の skills 配列末尾にエントリを追加(JSONとして妥当性を確認)
git add skills/<slug> registry.json
git commit -m "feat(skills): add <slug>"
git push -u origin add-skill-<slug>
gh pr create --title "スキル追加: <slug>" --body "<PR本文(下記テンプレ)>"

PR本文テンプレ:

## 追加スキル
- slug: <slug> / カテゴリ: <カテゴリ> / 投稿者: @<handle>
- 概要: <description>

## セルフチェック
- [x] precheck.sh 実行済み(機密・個人情報の検出なし)
- [x] 実名・取引先名・社内URLを含まない
- [x] 動作確認済み(自分の環境)

レビュアーへ: publish-check をお願いします。

6. 完了報告

PR の URL を提示し、こう伝える: 「PR を出しました。ここから先はレビュアーの公開チェック(機密・実名・公開同意)→ マージ → 自動デプロイで公開されます。公開されたら https://gyosui-skillmarket.pages.dev/skills/<slug> に載ります」

エラー時の対応

  • gh pr create が権限エラー → repo への Write 権限(チーム gyoumusuishin-ai)が必要。管理者に依頼するよう案内
  • push がガード等でブロックされる環境 → ブランチ名とコミット内容を提示し、手動 push の手順を案内