Claudeスキル

厳選されたzudo-doc-* Claude Codeスキルを生成プロジェクトに同梱します。

概要

create-zudo-docでプロジェクトをスキャフォールドすると、2つの独立したオプションによって、厳選されたzudo-doc-* Claude Codeスキルがプロジェクトの.claude/skills/ディレクトリに同梱されます：

• Claudeスキル（ユーザー向け） — 執筆・保守用スキル：zudo-doc自身の規約に従ってデザインシステムの編集、ドキュメントの翻訳、リリースの作成を支援します。

• Claudeスキル（ライティング） — AIエージェントにドキュメントの書き方とナビゲーション構造の正しい設計方法を教える、単一のライティングガイドスキルです。

これらは生成されたドキュメントではなく、実際に動作するスキルです。各スキルは自己完結したSKILL.mdで、create-zudo-docパッケージ自体の中でスキャフォールド向けのバリアントとして管理されており（zudo-docリポジトリからそのままコピーされたものではなく、生成プロジェクトのレイアウトに合わせて書き直されています）、プロジェクト内で開いたClaude Codeセッションでスラッシュコマンドとして利用できます。

どちらの機能もデフォルトで無効で、それぞれ独立して有効化できます — スキャフォールド時に片方だけ、両方、あるいはどちらも選ばないことができます。

Claudeスキル（ユーザー向け）

Claudeスキル（ユーザー向け）を有効にすると、3つのスキルがスキャフォールドされたプロジェクトの.claude/skills/にコピーされます：

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スキル（ライティング）

Claudeスキル（ライティング）を有効にすると、1つのスキルがスキャフォールドされたプロジェクトの.claude/skills/にコピーされます：

このスキルが存在するのは、ガイドなしで「ドキュメントを書いて」と頼まれたAIエージェントが、ほぼ確実に混沌としたナビゲーション構造を作ってしまうためです — ページが手近な場所に放り込まれ、カテゴリのランディングページがなく、サイドバーがアルファベット順に並ぶ、という状態です。このスキルはドキュメントの書き方とナビゲーションの構成方法のガイドを、エージェントがページを作成・編集する前に参照するルールに凝縮しており、生成されるドキュメントサイトを確実に良い形に保ちます。

対話型プロンプトでClaudeスキル（ライティング）を選択するか、CLIフラグを渡します：

pnpm create zudo-doc my-docs --claude-skills-writing

スキルの使用

スキャフォールド後、プロジェクトをClaude Codeで開き、スラッシュコマンドとしてスキルを呼び出します。たとえば、スタイルに手を加える前に：

/zudo-doc-design-system colors

あるいは、ドキュメントを書く前に：

/zudo-doc-writing

Claudeはルールを読み込み、変更に適用します。他のスキルも同様に、必要なときに名前で呼び出します。