Claude Code Skillsの作り方｜自分の業務をスキル化する実践手順

「おすすめSkills」を探すより、自分で作る方が早い

Claude Code Skillsの活用法として「おすすめSkills一覧」を求める人は多いですが、本質的な活用法は自分の業務をスキル化することです。誰かが作った汎用スキルより、自分の業務フローに完全に合わせたスキルの方が圧倒的に生産性が高い。

私自身、SEO記事のリサーチから執筆・画像生成・CMS投稿までを1つのSkillにまとめています。「記事を書いて」と一言指示するだけで、キーワード調査→構成作成→HTML執筆→サムネイル生成→MicroCMS投稿までが自動で完了します。この記事自体もそのSkillで書かれています。

この記事では、自分の業務をスキル化するための具体的な手順を解説します。

Skillsの基本構造

Skillsは.claude/skills/ディレクトリに配置するワークフロー定義です。最小構成はSKILL.mdファイル1つだけ。

.claude/skills/
└── my-skill/
    ├── SKILL.md          ← ワークフロー定義（必須）
    └── scripts/          ← 補助スクリプト（任意）
        └── helper.js

SKILL.mdに書く内容

トリガー条件: どんな指示でこのスキルが発動するか（例: 「SEO記事」「ブログ投稿」等のキーワード）
ワークフロー: 具体的な手順をステップバイステップで記述
データソース: 参照すべきファイルやAPIの情報
出力形式: 成果物のフォーマットや保存先

SKILL.mdは普通のマークダウンで書けます。YAMLやJSONのような厳密な構文は不要で、Claude Codeが理解できる自然言語で書けば機能します。

自分の業務をスキル化する3ステップ

ステップ1: 手動で繰り返している作業を特定する

スキル化すべき業務は、「毎回同じ手順で繰り返しているが、判断や微調整が必要な作業」です。完全に定型の作業ならシェルスクリプトで十分ですが、「毎回少し違う判断が入る」作業こそSkillsの真価が発揮されます。

私の場合、最初にスキル化したのはSEO記事の投稿フローでした。キーワード調査→記事執筆→画像生成→CMS投稿という手順は毎回同じですが、キーワードの選定や記事の切り口は毎回異なります。この「定型手順＋都度の判断」の組み合わせがSkillsに最適です。

ステップ2: 手順をClaude Codeに口頭で指示してみる

いきなりSKILL.mdを書くのではなく、まずはClaude Codeに口頭（テキスト）で一つずつ指示しながら業務を進めます。

「このCSVを読んでキーワードを分析して」「この情報をもとに記事を書いて」「画像を生成して」——こうしたやり取りを何度か繰り返す中で、毎回共通する手順と、毎回変わる部分が明確になります。この「共通する手順」がSKILL.mdに書くべき内容です。

ステップ3: SKILL.mdに手順を書き起こす

口頭指示で確立した手順をSKILL.mdにまとめます。ポイントは以下の3つです。

トリガーを明確に書く: 「SEO記事」「記事を書いて」など、どんな指示でスキルが発動するか
各ステップの判断基準を明記する: 「キーワードの月間検索ボリュームが500以上なら優先」など、AIが判断に迷わないよう基準を書く
参照すべきデータのパスを明記する: ファイルパス、APIの情報、データの形式を正確に記述する

実例: SEO記事投稿スキルの構成

私が実際に運用しているSEO記事投稿スキルの構成を紹介します。

ワークフローの全体像

ステップ0: 記事テーマの提案（キーワードCSV×既存記事CSV×実績DBを突き合わせ）
ステップ1: トピック確認→実績・知見DBから素材を自動抽出→不足情報をヒアリング
ステップ2: SEOルールに従った記事執筆（HTML形式、4,000〜6,000文字）
ステップ3: サムネイル画像生成（Gemini API）＋挿絵3枚生成（Puppeteer）
ステップ4: MicroCMSへ下書き投稿（MCP経由）
ステップ5: 既存記事CSVを更新

このスキルのSKILL.mdは約200行あります。最初から200行だったわけではなく、何度も記事を書く中で「こうした方がいい」と気づいたルールを追記して育てた結果です。

補助スクリプトの活用

SKILL.md単体で完結しない処理は、scripts/ディレクトリに補助スクリプトを配置します。私のスキルでは画像生成用のPythonスクリプトとPuppeteerによる図解生成スクリプトを配置しています。Claude Codeはこれらのスクリプトを自動的に呼び出して実行します。

skill-creatorを活用する

Skillsの自作に慣れないうちは、skill-creator（スキルを作るためのスキル）を使うのが効率的です。GitHubで公開されている人気のskill-creatorをインストールし、「こういう業務を自動化したい」と伝えるだけで、SKILL.mdのひな形を自動生成してくれます。

もう一つの有効な方法は、GitHubでスター数が多い人気スキルを収集→中身を読んで構造を理解→自分のワークフローに合うよう改良すること。ゼロから書くより、良いスキルを参考にして改良する方が圧倒的に早く、品質も高くなります。