Claudeスキル(ユーザー向け)
厳選されたzudo-doc-* Claude Codeスキルを生成プロジェクトに同梱します。
概要
create-zudo-docでプロジェクトをスキャフォールドすると、Claudeスキル(ユーザー向け)オプションによって、厳選されたzudo-doc-* Claude Codeスキルがプロジェクトの.claude/skills/ディレクトリに同梱されます。これらは生成されたドキュメントではなく実際に動作するスキルで、zudo-doc自身の規約に従ってデザインシステムの編集、ドキュメントの翻訳、リリースの作成を支援します。
この機能はデフォルトで無効です。同梱されたスキルを新しいプロジェクトにコピーしたい場合は、スキャフォールド時に有効化してください。
Info
これは、.claude/ディレクトリからドキュメントページを自動生成するClaude Codeリソースや、ドキュメントを参照用スキルに変換するドキュメントスキルシンボリックリンカーとは異なります。Claudeスキル(ユーザー向け)は、既製の執筆用スキルをプロジェクトに同梱します。
同梱されるもの
この機能を有効にすると、zudo-docモノレポから3つのスキルがスキャフォールドされたプロジェクトの.claude/skills/にコピーされます:
| スキル | 目的 |
|---|---|
zudo-doc-design-system | プロジェクト固有のCSSおよびコンポーネントルール — デザイントークン、三層カラーアーキテクチャ、コンポーネントファースト戦略。CSS、Tailwindクラス、カラートークン、コンポーネントマークアップを編集する前に参照します。 |
zudo-doc-translate | zudo-docのバイリンガル規約に従って、ドキュメントを英語と日本語の間で翻訳します。 |
zudo-doc-version-bump | パッケージバージョンの更新、changelogドキュメントの生成、コミット、タグ付け、GitHubリリースの作成を行います。 |
各スキルは自己完結したSKILL.md(およびバンドルされたリファレンス)であり、プロジェクト内で開いたClaude Codeセッションでスラッシュコマンドとして利用できます。
機能の有効化
create-zudo-docの対話型プロンプトでClaudeスキル(ユーザー向け)を選択するか、CLIフラグを渡します:
pnpm create zudo-doc my-docs --claude-skillsオプトインしない限り、この機能は無効です。
その他に設定されるもの
zudo-doc-version-bumpはリリースフローの一部として<パッケージマネージャー> b4pushを実行するため、この機能を有効にすると、新しいプロジェクトでスキルが「スクリプトが見つからない」エラーで失敗しないように、生成されるpackage.jsonに最小限のb4pushスクリプトも追加されます:
{
"scripts": {
"b4push": "pnpm check && pnpm build"
}
}これは意図的に小さなスタブ — 型チェックの後にビルドを行うだけ — です。後でより充実したプッシュ前パイプラインに拡張するのは自由です。
スキルの使用
スキャフォールド後、プロジェクトをClaude Codeで開き、スラッシュコマンドとしてスキルを呼び出します。たとえば、スタイルに手を加える前に:
/ zudo- doc- design- system colorsClaudeはデザインシステムのルールを読み込み、変更に適用します。translateスキルとversion-bumpスキルも同様に、必要なときに名前で呼び出します。
Tip
同梱されたスキルはプロジェクトの.claude/skills/に配置され、自由に編集できます。出発点として扱い、チームの働き方に合わせて規約を調整してください。