開発作業中に、特定のGit操作やエディタのショートカットを思い出せないことはよくある。従来はドキュメントやWeb検索に頼るしかなかったが、claude-code-cheatsheetというAIスキルを使えば、自然言語で即座に正確なコマンドを取得できる。

スキルの概要と利点

このスキルは、静的なチートシートを動的なクエリ可能な知識ベースへと変換するもので、Agent Skills標準に準拠している。インストール後は、AIアシスタント（Claude Code、Cursor、Copilotなど）のチャット欄に/guide [質問]と入力するだけで、目的に合ったコマンドや説明が返ってくる。上下文切り替えのコストを大幅に削減し、開発フローを途切れさせずに済む。

設計思想：静的知識から対話型スキルへ

従来のチートシートは単なる参照資料だったが、このプロジェクトでは以下の3点を実現している：

1. スキル化による再利用性：Agent Skills標準により、複数のAIプラットフォームで共通して利用可能。
2. 自然言語インターフェース：/guideに続く質問は日常的な英語でOK。例: /guide how to search codebase や /guide keyboard shortcuts。
3. 構造化された知識ベース：コマンド、ショートカット、ワークフローが意味的に関連付けられ、曖昧な質問にも正確に応答可能。

インストール手順

以下の1行コマンドでインストール可能：

npx skills add jcdentonintheflesh/claude-code-cheatsheet

前提条件として、Node.js（LTS推奨）とネット接続が必要。インストール後、AIアシスタントを再起動すると/guideコマンドが有効になる。

主な使用シーン

• コマンドの即時検索：/guide find all usages of function X → grep -r "X" . またはエディタのグローバル検索ショートカットを返す。
• 概念の学習：/guide what is git worktree → 概要と使用例（git worktree add ../branch-name branch-name）を提供。
• ショートカット一覧：/guide keyboard shortcuts → ナビゲーション・編集・検索などのカテゴリ別ショートカットを表示。
• ミスの修正ガイド：/guide forgot file in last commit → git add <file> && git commit --amend --no-edit を提案し、プッシュ済みの場合の注意点も付記。

内部動作の推測

スキルパッケージは以下のような構成を想定：

skill.json       # コマンド定義とメタ情報
index.js         # クエリ処理ロジック
knowledge/
  ├── git.json
  ├── shortcuts.json
  └── workflows.json

クエリ処理では、入力テキストからキーワードを抽出し、知識ベース内のエントリと意味的類似度に基づいてマッチングを行う。ベクトル検索やルールベースの照合が採用されている可能性がある。重要なのは、回答が生成ではなく、事前に検証された知識からの検索結果である点だ。

上級テクニック

• 質問の具体化：「どうやってGitを使う？」ではなく、「別のブランチの特定コミットをマージするには？」のように詳細に記述。
• ツール名の明示：/guide global replace in editor のように対象ツールを指定すると精度向上。
• カスタマイズの可能性：MITライセンスのため、Forkして日本語化やVS Code向けショートカットへの置き換えが可能。チーム内ツールのガイドスキルとしても活用できる。

トラブルシューティング