Skill
claude-code-skillset
hideki1219/claude-code-skillset
43
InicialPluginScore · de 0 a 100Instalação
$
npx convez-ai hideki1219/claude-code-skillset1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Estrelas
0Forks
0Acompanhando
0Saúde
14%Último commit
há 5 mesesVersão
—Issues abertas
0Contribuidores
1README
A tradução para o português deste README ainda está na fila.
Claude Code 武器庫 — Next.js Web アプリ開発用スターターキット
Claude Code の能力を最大限引き出すための拡張一式。リポジトリ直下にそのまま配置して使う。 各ファイルは自己完結で書かれているため、低レベルのモデルに「この形式で◯◯のスキルを作って」と渡せばそのまま量産できる。
設計思想 — 5つの拡張ポイントの使い分け
| 拡張ポイント | 役割 | 一言でいうと | 読み込まれるタイミング |
|---|---|---|---|
CLAUDE.md | 憲法 | 常に守る短い絶対ルール | 毎セッション常時 |
skills/ | 知識 | 工程ごとの手順書・規約 | 関連タスクの時だけ |
hooks/ | 強制 | AIの善意に頼らない機械的ガード | ツール実行の前後に自動 |
commands/ | 定型作業 | よくやる作業のワンコマンド化 | /コマンド名 で明示的に |
agents/ | 分業 | 別人格・別コンテキストでの専門作業 | 必要時に自動 or 指名 |
判断基準:
- 絶対に毎回守らせたい短いルール → CLAUDE.md(長くしない。長い知識はスキルへ)
- 特定の工程でだけ必要な長い知識 → スキル(コンテキストを汚さない)
- 「守ってほしい」では足りない、確実に止めたい操作 → hooks(LLMは確率的、hooksは決定的)
- 毎回同じ指示を打っている作業 → コマンド
- 「書いた本人と別の目」が欲しい作業(レビュー・監査) → サブエージェント
ファイル構成
CLAUDE.md # プロジェクト規約(憲法)
.claude/
├── settings.json # hooks 設定 + 許可/拒否パーミッション
├── hooks/ # Node.js 製(クロスプラットフォーム)
│ ├── block-dangerous.mjs # [実行前] rm -rf / force push / DROP 等をブロック
│ ├── protect-files.mjs # [編集前] .env / 既存マイグレーション等の編集をブロック
│ ├── format-on-edit.mjs # [編集後] Prettier 自動整形
│ └── stop-typecheck.mjs # [完了時] 型エラーが残っていたら差し戻す品質ゲート
├── commands/
│ ├── plan.md # /plan 実装計画のみ(コード変更禁止)
│ ├── tdd.md # /tdd テスト先行で実装
│ ├── review.md # /review 差分レビュー
│ ├── commit.md # /commit Conventional Commits でコミット
│ └── pr.md # /pr 品質チェック後に PR 作成
├── agents/
│ ├── code-reviewer.md # レビュー専門(修正権限なし)
│ ├── test-writer.md # テスト専門(実装コード変更禁止)
│ └── security-auditor.md # セキュリティ監査(読み取り専用)
└── skills/
├── requirements/ # 【要件定義】曖昧な要望→検証可能な要件
├── design-doc/ # 【設計】設計書 + ADR
├── nextjs-conventions/ # 【実装】App Router 規約
├── db-schema/ # 【実装】Prisma スキーマ/マイグレーション規約
├── testing/ # 【テスト】Vitest + Playwright 規約
├── debugging/ # 【保守】障害調査の手順
└── release-notes/ # 【リリース】CHANGELOG / PR説明文
工程カバレッジ
要件定義 ──► 設計 ──────► 実装 ─────────► テスト ──► レビュー ──► リリース ──► 運用保守
requirements design-doc nextjs-conventions testing code-reviewer release-notes debugging
(/plan) (ADR) db-schema (/tdd) (/review) (/commit /pr)
+ hooks が全工程を常時ガード + stop-typecheck が完了品質を担保
導入手順
- このフォルダの中身をプロジェクトルートにコピーする(
.claude/とCLAUDE.md) CLAUDE.mdの技術スタック・コマンドを実プロジェクトに合わせて書き換える (pnpm → npm、Prisma → Drizzle 等。スキル内のコマンド名も同様に)package.jsonにtypecheck: "tsc --noEmit"等のスクリプトがあることを確認する- Claude Code を起動し、
/hooksで hooks が認識されているか確認する - 動作確認: 「
.envを読んで」と頼んでブロックされれば成功
注意:
- hooks は Node.js で書いてあるため、Next.js プロジェクトなら追加依存ゼロで動く
settings.jsonはチーム共有用。個人設定はsettings.local.jsonに分離する- 仕様の確認は公式リファレンス: https://code.claude.com/docs/en/hooks
低レベルモデルでも量産できる「言語化」原則
新しいスキル・コマンド・エージェントを(人間でも弱いモデルでも)作る時は、この5原則を守る。 この原則自体をプロンプトに貼り付ければ、量産を指示できる。
- 1ファイル1責務。 「テストとデバッグのスキル」のように混ぜない。迷ったら分割する。
- description にトリガー条件を全部書く。 スキルが使われるかは description だけで決まる。 「何をするか」+「ユーザーがどんな言葉を使った時に発動するか」を具体的な語彙で列挙し、 少し押し付けがましいくらいに「必ず使う」と書く(スキルは発動しそびれる方向に偏るため)。
- 本文は命令形+具体例。 「〜が望ましい」ではなく「〜する」「〜禁止」。 抽象的な規約には必ず短いコード例かテンプレートを1つ添える。
- 理由を1行添える。 「禁止(履歴が壊れるため)」のように書くと、モデルが応用判断できる。
- 短く保つ。 スキル本文は100行以内を目安、最大でも500行。 超えたら references/ サブファイルに分離し、SKILL.md から「いつ読むか」を指示する。
加えて、種類ごとの型:
- スキル =
skills/<名前>/SKILL.md。frontmatter にnameとdescription(原則2が最重要) - コマンド =
commands/<名前>.md。本文がそのままプロンプトになる。$ARGUMENTSで引数を受ける - エージェント =
agents/<名前>.md。frontmatter のtoolsで権限を絞るのが本質 (レビュアーに Write を与えない=「口だけ出す」を構造で保証する) - hook = 「LLM に守らせる」のではなく「機械的に不可能にする」もの。 exit 0 = 許可、exit 2 + stderr = ブロック(stderr の文章が Claude への指導になる)
運用のコツ
- 同じ指摘を2回したら、それは CLAUDE.md かスキルに追記するサイン
- 同じ事故が2回起きたら、それは hooks に追加するサイン(ルールではなくガードにする)
- スキルが発動しない時は description を疑う(本文ではなく)
- 定期的に CLAUDE.md を見直し、守られていないルールは「短くする・具体化する・hooks 化する」のどれかで対処する