launch-shadcn-registry

中文版: SKILL.zh-CN.md

shadcn レジストリを公開する

カスタム shadcn/ui レジストリ向けのディレクトリ投稿を準備し、その後、各プラットフォームに合った投稿を作成します。

はじめる前に

ユーザーが完全なローンチを望んでいるのか、選択したターゲットのみを望んでいるのかを確認してください。範囲を絞らない限り、デフォルトでは完全なワークフローとします。

レジストリプロファイルを収集するか推測してください。投稿を生成する前に、不足している必須フィールドについて質問してください。形状として templates/registry-profile.example.json を使用し、templates/registry-profile.schema.json に対して検証してください。

必須のプロファイルフィールド:

フィールド	目的
scope	@ogimagecn などのレジストリスコープ
name	表示名
homepage	公開プロジェクトまたはドキュメントの URL
registryBaseUrl	末尾スラッシュなしの JSON ファイルのベース URL
componentUrlPattern	{name} プレースホルダーを含む URL パターン。例: https://example.com/r/{name}.json
description	160 文字以内のディレクトリ用 1 文
descriptionLong	awesome リストおよびソーシャル投稿用の 2 ～ 3 文
githubUrl	ソースリポジトリ
githubUsername	アバター URL およびファイル名用
distribution	open-source または premium
categories	shadcntemplates および awesome リスト用のタグ
installExample	npx shadcn@latest add @scope/component-name などの完全なインストールコマンド
logo	オプションのインライン SVG 文字列。公式ディレクトリに推奨
registryIndexPath	オプションの registryBaseUrl からの相対レジストリインデックスパス。デフォルトは /registry.json
sampleComponents	プリフライト中に検証するオプションのコンポーネントスラッグ。例: ["og-image"]
features	shadcntemplates およびソーシャル投稿用のオプションのポイント
mcpUrl	レジストリドメイン上のオプションの MCP エンドポイント。例: https://example.com/mcp。awesome-ai-devtools には必須
freeTier	具体的な制限を含むオプションの無料枠の文。free-for-dev には必須
pricingUrl	オプションの公開価格ページ URL。free-for-dev には必須

ワークフロー

このチェックリストをコピーして進捗を追跡してください:

Launch Progress:
- [ ] Phase 1: Preflight validation
- [ ] Phase 2: Generate directory artifacts
- [ ] Phase 3: Open GitHub pull requests after user approval
- [ ] Phase 4: Draft social posts
- [ ] Phase 5: Post-launch follow-up

フェーズ 1: プリフライト

references/preflight.md を読み、PR を生成する前に検証を実行してください。

bash scripts/validate-registry.sh <registryBaseUrl> [sample-component-name]

続行する前にすべてのブロッカーを修正してください。よくある失敗:

• registry.json が公開されていない、またはパスが間違っている
• コンポーネント JSON の 404
• 公式ディレクトリ内の @scope の重複
• 公式リスティングに対して description が長すぎる、またはマーケティング色が強すぎる

公式ディレクトリを取得して重複を確認してください:

curl -fsSL https://raw.githubusercontent.com/shadcn-ui/ui/main/apps/v4/registry/directory.json | grep -i "<scope>"

フェーズ 2: 成果物を生成する

レジストリプロファイルから要求された投稿ファイルを生成します。それらのターゲットのリファレンスのみを読んでください。

ターゲット	リファレンス	出力
公式 shadcn-ui/ui	references/shadcn-ui-official.md	JSON エントリ + PR 本文
registry.directory	references/registry-directory.md	JSON エントリ + PR 本文
shadcntemplates	references/shadcntemplates.md	content/{author}-{name}.md
birobirobiro awesome	references/awesome-birobirobiro.md	README テーブル行
bytefer awesome	references/awesome-bytefer.md	README テーブル行
free-for-dev	references/free-for-dev.md	README 箇条書き、ホスト型 SaaS の無料枠を条件とする
awesome-ai-devtools	references/awesome-ai-devtools.md	README 箇条書き、ドメイン由来の mcpUrl を持つ MCP サーバーのみ

成果物をリポジトリごとにグループ化して提示してください。以下を含めます:

1. 作成または編集する正確なファイルパス
2. 部分的な差分ではなく、追加する完全な内容
3. 提案する PR タイトルと本文

PR タイトルの規約

公式の shadcn-ui/ui には feat(registry): add <scope> を使用してください。これは PR #10896 と一致します。awesome リストには docs: add <name> to <section>、registry.directory には feat: add <name> registry を使用してください。

フェーズ 3: GitHub プルリクエストを開く

GitHub の操作には gh を使用してください。ユーザーがすでにすべてを開くよう依頼していない限り、各プルリクエストを作成する前に確認してください。

リポジトリごとの標準的な fork-and-PR フロー:

# Example: official shadcn-ui/ui
gh repo fork shadcn-ui/ui --clone=false
git clone https://github.com/<user>/ui.git /tmp/ui-registry-pr
cd /tmp/ui-registry-pr
git remote add upstream https://github.com/shadcn-ui/ui.git
git fetch upstream && git checkout -b feat/<scope>-directory upstream/main
# append the entry to apps/v4/registry/directory.json
git add apps/v4/registry/directory.json
git commit -m "feat(registry): add <scope>"
git push -u origin HEAD
gh pr create --repo shadcn-ui/ui --title "feat(registry): add <scope>" --body "$(cat <<'EOF'
## Summary
Adds <scope> to the community registry directory.

- Registry URL: `<componentUrlPattern>`
- Homepage: <homepage>
- Description: <description>

## Test plan
- [ ] `curl <registryBaseUrl>/registry.json` returns valid JSON
- [ ] `npx shadcn@latest add <installExample>` installs successfully
EOF
)"

ユーザーが別途指定しない限り、次の順序でプルリクエストを開いてください:

1. 公式の shadcn-ui/ui。最も目に触れる掲載先であり、メンテナーのレビューが必要になる可能性が最も高いものです
2. rbadillap/registry.directory
3. shadcnblocks/shadcntemplates
4. birobirobiro/awesome-shadcn-ui と bytefer/awesome-shadcn-ui。これらは並行して実行できます
5. jamesmurdza/awesome-ai-devtools。レジストリが独自ドメインで検証済みの MCP サーバーを提供している場合のみ
6. ripienaar/free-for-dev。レジストリのドメインが SaaS の無料枠を提供している場合のみ。レビューが最も遅いため、最後に提出してください

プルリクエストの URL はローンチチェックリストで追跡してください。レジストリが公開され、少なくとも 1 件のディレクトリへの提出がオープンまたはマージされるまでは、そのレジストリを公開済みとして説明しないでください。

フェーズ 4: ソーシャル投稿の下書き

プラットフォームのリファレンスを読み、そのまま貼り付けられる下書きを作成してください。投稿はユーザーが手動で行います。

プラットフォーム	リファレンス
Reddit r/shadcn	references/social/reddit.md
X	references/social/x.md
Dev.to	references/social/devto.md
Hacker News	references/social/hackernews.md

各下書きはレジストリのプロフィールに合わせて調整してください。インストールコマンド、ホームページ、GitHub リンクを含めてください。誇大表現は避け、レジストリが解決する具体的な問題を先頭に持ってきてください。

ソーシャル投稿の下書きは、プリフライトが通過した後に作成してください。公開は公式ディレクトリのプルリクエストがマージされた後にすることを提案してください。少なくとも registry.json が公開されるまでは待ってください。

フェーズ 5: フォローアップ

PR がオープンまたはマージされた後:

1. 各提出について、リポジトリ、プルリクエストの URL、ステータスを共有する
2. レビューコメントには 48 時間以内に返信するようユーザーに促す
3. 公式のマージ後、レジストリが shadcn レジストリディレクトリに掲載されたことを伝えるようソーシャルの下書きを更新する
4. プルリクエストが却下された場合は、メンテナーのフィードバックを読み、説明またはレジストリの形式を修正してから再提出する

ルール

上記のフェーズでまだ示されていないガードレール:

• 公式の directory.json エントリは配列の末尾に追加してください。
• すべての提出で 1 つのレジストリプロフィールを使用してください。ユーザーの承認なしに、矛盾する説明をでっち上げないでください。
• shadcntemplates のプレミアムレジストリについては、最初の掲載は無料で、追加の掲載には 100 ドルかかることを説明してください。承認を約束しないでください。
• レジストリに MCP サーバーがない場合は awesome-ai-devtools をスキップし、SaaS の無料枠がない場合は free-for-dev をスキップしてください。下書きを作成する代わりに、その理由を述べてください。
• awesome-ai-devtools のリンクはレジストリのドメイン（profile.mcpUrl、 デフォルトは {homepage}/mcp）から導出し、下書きの前にエンドポイントを検証してください。

追加リソース

• レジストリプロフィールのスキーマ: templates/registry-profile.schema.json
• プロフィールの例: templates/registry-profile.example.json
• 検証スクリプト: scripts/validate-registry.sh