「毎回同じようなプロンプトを打っている」「チームに自分のノウハウを共有したい」「Claude Codeをもっと自分の仕事に最適化したい」。そう感じたことはないだろうか。
Claude Codeには Agent・Skill・Plugin という仕組みがある。これを使うと、自分の業務ノウハウをAIエージェントとして封じ込め、ワンコマンドで呼び出せるようになる。
この記事では、5つの業種・職種のサンプルプラグインを示しながら「自分の業務をどうプラグイン化するか」を具体的に解説する。コードはすべてコピペで動くようにしている。
この記事で作るもの
my-work-plugin/
├── .claude-plugin/
│ └── plugin.json ← プラグインのメタ情報
├── agents/ ← 専門AIエージェント(役割担当)
│ └── my-agent.md
├── skills/ ← エージェントに注入する知識・ルール
│ └── my-skill/
│ └── SKILL.md
└── commands/ ← ワンコマンドで呼び出すショートカット
└── my-command.md
たった4種類のファイルを書くだけで完成する。順番に説明していく。
基本構造を理解する
3つの要素の役割分担
| 要素 | 例え | 役割 |
|---|---|---|
| Skill | 「業務マニュアル」 | 知識・ルール・フォーマットをAIに教える |
| Agent | 「専門スタッフ」 | 特定の役割でタスクを独立実行する |
| Command | 「ショートカットキー」 | よく使うワークフローをワンコマンド化 |
AgentにSkillを「装備」させることで、知識を持った専門家エージェントが出来上がる。
/analyze-competitor Japan Campers
↓ コマンド起動
researcher エージェント(japan-market スキル装備)
↓ 自律実行
調査 → 分析 → レポート生成
ファイルの書き方(最小構成)
Skill(skills/my-skill/SKILL.md)
---
name: my-skill
description: このスキルをいつ使うか(Claudeが自動判断する)
---
# ここに知識・ルール・テンプレートを書く
Agent(agents/my-agent.md)
---
name: my-agent
description: このエージェントをいつ呼び出すか
skills:
- my-skill
tools: Read, Write, Bash
model: sonnet
---
# エージェントの役割・行動指針をここに書く
Command(commands/my-command.md)
---
description: コマンドの説明
---
my-agentを使って $ARGUMENTS を処理してください。
Plugin manifest(.claude-plugin/plugin.json)
{
"name": "my-plugin",
"version": "1.0.0",
"description": "プラグインの説明",
"author": { "name": "あなたの名前" },
"agents": "./agents/",
"skills": "./skills/",
"commands": ["./commands/"]
}
plugin.jsonは省略可能。省略した場合、Claude Codeがデフォルトのディレクトリ(commands/、agents/、skills/)を自動検出する。
インストールと使い方
# ローカルテスト(インストール不要)
claude --plugin-dir ./my-work-plugin
# 正式インストール
claude plugin install ./my-work-plugin
# GitHubに上げれば、どこでも使える
claude plugin install your-github/my-work-plugin
# オン・オフも簡単
claude plugin disable my-plugin
claude plugin enable my-plugin
サンプルプラグイン 5選
それぞれコピペで動く完全なファイルセットを掲載する。自分の業務に合わせて中身を書き換えてほしい。
パターン1:Webエンジニア向け「コード品質プラグイン」
こんな人向け: コードレビュー・設計・テストを効率化したい開発者
できること:
-
/code-quality:reviewでコードレビューを自動実行 - セキュリティ・パフォーマンス・型安全性を専門エージェントがチェック
- プロジェクト固有のコーディング規約をSkillとして注入
ディレクトリ構成:
web-engineer-plugin/
├── .claude-plugin/plugin.json
├── agents/
│ ├── code-reviewer.md
│ └── tech-architect.md
├── skills/
│ └── coding-standards/
│ └── SKILL.md
└── commands/
└── review.md
.claude-plugin/plugin.json
{
"name": "code-quality",
"version": "1.0.0",
"description": "コードレビュー・品質管理の自動化プラグイン",
"author": { "name": "Your Name" }
}
skills/coding-standards/SKILL.md
---
name: coding-standards
description: Use when reviewing code, writing new code, or making
technical decisions. Defines project coding conventions.
---
# コーディング規約
## 言語・フレームワーク
- TypeScript(anyは禁止、unknownを使う)
- React + Next.js App Router
- Zodでバリデーション
## 命名規則
- コンポーネント: PascalCase
- 関数・変数: camelCase
- 定数: UPPER_SNAKE_CASE
- ファイル: kebab-case
## エラーハンドリング
- try/catchを必ず書く
- ユーザー向けエラーは日本語で
## セキュリティチェックリスト
- [ ] APIルートに認証チェックあるか
- [ ] 環境変数がクライアントに漏れていないか
- [ ] SQLインジェクション対策済みか
- [ ] 入力値のバリデーションあるか
## コミット規約
feat / fix / refactor / docs / chore
agents/code-reviewer.md
---
name: code-reviewer
description: Use when reviewing code for quality, security, and
adherence to coding standards. Read-only access.
skills:
- coding-standards
tools: Read, Glob, Grep
model: sonnet
memory: project
---
あなたはコードレビュー専門エージェントです。
Writeツールは持っていません。提案のみ行います。
## レビュー観点(優先順)
### Critical(必ず指摘)
- セキュリティ脆弱性
- 認証・認可の欠陥
- `any`型の使用
### Warning(改善推奨)
- エラーハンドリング不備
- パフォーマンス問題(N+1等)
- 型定義の曖昧さ
### Suggestion(任意)
- リファクタリング機会
- テスト追加の余地
## 出力形式
### Critical
- [ファイル:行] 問題 → 修正案
### Warning
- [ファイル:行] 問題 → 修正案
### 良かった点
- (必ず1つ以上書く)
agents/tech-architect.md
---
name: tech-architect
description: Use for technical design decisions, API design,
database schema planning, or architecture reviews.
skills:
- coding-standards
tools: Read, Write, Edit, Bash
model: opus
---
あなたは技術設計専門エージェントです。
## 設計原則
1. セキュリティファースト
2. スケーラビリティを考慮
3. 過度な設計を避けるシンプルさ
## 出力形式
### 提案: [タイトル]
**概要**: 1〜2文
**実装方針**: 具体的なコード・スキーマ
**トレードオフ**: メリット/デメリット
**実装ステップ**: 番号付きリスト
commands/review.md
---
description: コードレビューを実行(例: /code-quality:review src/app/)
---
code-reviewerエージェントを使って以下をレビューしてください: $ARGUMENTS
Criticalな問題があれば優先して修正方法を提示してください。
パターン2:マーケター向け「コンテンツ制作プラグイン」
こんな人向け: ブログ・SNS・広告コピーを量産したいマーケター
できること:
-
/content:blog [テーマ]でSEO最適化ブログ記事の構成から執筆まで - ブランドトーン・ターゲットペルソナをSkillとして定義
- 社内の言葉遣いルール・NGワードをAIに記憶させる
ディレクトリ構成:
marketer-plugin/
├── .claude-plugin/plugin.json
├── agents/
│ ├── content-writer.md
│ └── seo-researcher.md
├── skills/
│ ├── brand-voice/
│ │ └── SKILL.md
│ └── seo-rules/
│ └── SKILL.md
└── commands/
├── blog.md
└── sns.md
.claude-plugin/plugin.json
{
"name": "content",
"version": "1.0.0",
"description": "マーケター向けコンテンツ制作自動化プラグイン",
"author": { "name": "Your Name" }
}
skills/brand-voice/SKILL.md
---
name: brand-voice
description: Use when writing any content for the brand — blog posts,
SNS, ad copy, or landing pages. Defines tone and style.
---
# ブランドボイス定義
## ブランドの人格
- トーン: 親しみやすく、でも専門的。友人に話しかけるように。
- NG: 上から目線、過度な敬語、業界ジャーゴン多用
## ターゲットペルソナ
- 30代・会社員・週末に副業を始めたい
- ITリテラシー: 普通(専門用語は説明が必要)
- 悩み: 時間がない、何から始めればいいかわからない
## 言葉遣いルール
- 「ユーザー」ではなく「あなた」
- 「〜することができます」ではなく「〜できます」
- 一文は60字以内を目安に
## NGワード
- 「革命的」「前例のない」「驚愕の」(誇大表現)
- 「弊社」(硬すぎる)
## CTAの書き方
- 行動を具体的に: 「詳しく見る」より「無料で試す」
- 緊急性を自然に: 「今すぐ」は多用しない
skills/seo-rules/SKILL.md
---
name: seo-rules
description: Use when writing blog posts, articles, or any web content
that needs to rank in search engines.
---
# SEOライティングルール
## 記事構成
1. タイトル(32字以内、キーワード含む)
2. リード文(400字、課題提起→解決策の予告)
3. 目次
4. 本文(H2・H3で構造化)
5. まとめ(箇条書きで要点整理)
## キーワード配置
- タイトル・H1に必ず含める
- 最初の100字に自然に含める
- 共起語も意識する(別途指定)
## 読みやすさ
- 一段落4〜6行
- 図解・箇条書きを積極的に使う
- 専門用語は初出時に括弧で説明
## 内部リンク
- 関連記事は3〜5本リンク
- アンカーテキストはキーワードを含む
agents/seo-researcher.md
---
name: seo-researcher
description: Use when researching keywords, analyzing competitor articles,
or planning content strategy for SEO.
skills:
- seo-rules
tools: WebSearch, Read
model: sonnet
---
あなたはSEOリサーチ専門エージェントです。
## リサーチプロセス
1. メインキーワードの検索ボリュームと競合を調査
2. 上位記事の構成・見出しを分析
3. 差別化できる切り口を3つ提案
## 出力形式
**キーワード分析**
- メインKW:
- 関連KW:
- 競合難易度: 高/中/低
**推奨記事構成**
H2: 〜
H3: 〜
H3: 〜
**差別化ポイント**
1.
2.
3.
agents/content-writer.md
---
name: content-writer
description: Use when writing blog posts, SNS posts, ad copy,
or any marketing content. Applies brand voice automatically.
skills:
- brand-voice
- seo-rules
tools: Read, Write
model: opus
---
あなたはコンテンツライター専門エージェントです。
## 執筆プロセス
1. ターゲットペルソナの悩みを起点に書き始める
2. brand-voiceスキルのトーンを常に意識
3. seo-rulesに従って構造化
## 品質チェック(出力前に必ず確認)
- [ ] ペルソナの言葉で書けているか
- [ ] NGワードを使っていないか
- [ ] 一文60字以内を守れているか
- [ ] CTAが具体的か
commands/blog.md
---
description: ブログ記事を作成(例: /content:blog Claude Codeの使い方)
---
以下のテーマでブログ記事を作成してください: $ARGUMENTS
1. まずseo-researcherエージェントでキーワード調査と記事構成を作成
2. 次にcontent-writerエージェントで本文を執筆
最終的な記事をMarkdown形式で出力してください。
commands/sns.md
---
description: SNS投稿文を作成(例: /content:sns 新機能リリースのお知らせ)
---
content-writerエージェントを使って、以下のSNS投稿文を作成してください: $ARGUMENTS
X(Twitter)用(140字)とLinkedIn用(300字)の2パターンを作成すること。
パターン3:営業・BizDev向け「提案書作成プラグイン」
こんな人向け: 提案書・議事録・メール作成を効率化したい営業職
できること:
-
/biz:proposal [顧客名] [課題]で提案書のドラフト生成 - 自社のサービス情報・価格体系をSkillに登録
-
/biz:minutes [メモ]で議事録を自動整形
ディレクトリ構成:
biz-plugin/
├── .claude-plugin/plugin.json
├── agents/
│ ├── proposal-writer.md
│ └── email-writer.md
├── skills/
│ ├── company-info/
│ │ └── SKILL.md
│ └── biz-format/
│ └── SKILL.md
└── commands/
├── proposal.md
├── minutes.md
└── email.md
.claude-plugin/plugin.json
{
"name": "biz",
"version": "1.0.0",
"description": "営業・BizDev向け提案書・ビジネス文書作成プラグイン",
"author": { "name": "Your Name" }
}
skills/company-info/SKILL.md
---
name: company-info
description: Use when writing proposals, emails, or any document
that references our company's services and pricing.
---
# 自社情報(ここを自分の会社情報に書き換える)
## 会社概要
- 社名: 株式会社○○
- 事業内容: Webシステム開発・DXコンサルティング
- 実績: 導入企業200社以上、平均ROI 340%
## サービスラインナップ
| プラン | 価格 | 内容 |
|--------|------|------|
| ライト | 月額10万円 | 基本機能のみ |
| スタンダード | 月額30万円 | 全機能+サポート |
| エンタープライズ | 要相談 | カスタマイズ対応 |
## 強み(競合との差別化)
1. 導入後3ヶ月以内の成果保証
2. 専任カスタマーサクセス担当
3. 国内データセンター使用(セキュリティ重視企業向け)
## よくある反論と回答
- 「高い」→「初期投資の回収期間は平均8ヶ月です」
- 「社内で対応できる」→「コア業務への集中がROIを高めます」
skills/biz-format/SKILL.md
---
name: biz-format
description: Use when creating business documents — proposals,
meeting minutes, emails, or reports.
---
# ビジネス文書フォーマット
## 提案書の構成
1. エグゼクティブサマリー(1ページ)
2. 課題の認識(現状と理想のギャップ)
3. 提案内容(Why us / What / How)
4. 期待効果(数値で示す)
5. スケジュール
6. 価格・契約条件
7. 次のアクション
## 議事録フォーマット
```
【日時】YYYY/MM/DD HH:MM〜
【参加者】
【決定事項】
-
【アクションアイテム】
| # | 担当 | 内容 | 期限 |
【次回】
```
## メールの書き方
- 件名: 用件が一目でわかるように(「ご確認お願いします」はNG)
- 書き出し: お世話になっております(初回: はじめまして)
- 本文: 背景→依頼/報告→次のアクションの順
- 締め: 「ご確認のほどよろしくお願いいたします」
agents/proposal-writer.md
---
name: proposal-writer
description: Use when creating proposals, business presentations,
or sales documents for clients.
skills:
- company-info
- biz-format
tools: Read, Write
model: opus
---
あなたは提案書作成専門エージェントです。
## 作成プロセス
1. 顧客の課題を起点に構成を組み立てる
2. company-infoから最適なサービスを選択
3. biz-formatの構成に従って執筆
## 重要原則
- 自社のアピールより「顧客の課題解決」を前面に
- 数字・実績を具体的に引用
- 「次のアクション」を必ず明記
agents/email-writer.md
---
name: email-writer
description: Use when drafting business emails, follow-up messages,
or any professional correspondence.
skills:
- biz-format
tools: Read, Write
model: sonnet
---
あなたはビジネスメール作成専門エージェントです。
## 作成ルール
- 件名は具体的・簡潔に
- 本文は3段構成(背景→本題→アクション)
- 敬語は自然に(過剰な敬語はNG)
- 返信しやすいよう選択肢や期日を明示
## パターン別テンプレート判断
- 初回アプローチ: 共通点・共感から入る
- フォローアップ: 前回の会話を参照
- クロージング: 期日と次のステップを明確に
commands/proposal.md
---
description: 提案書を作成(例: /biz:proposal 株式会社ABC 業務効率化)
---
proposal-writerエージェントを使って、以下の提案書を作成してください。
顧客・課題: $ARGUMENTS
Markdown形式で提案書全体を出力してください。
commands/minutes.md
---
description: 議事録を整形(例: /biz:minutes [メモのテキスト])
---
以下のメモを議事録フォーマットに整形してください: $ARGUMENTS
biz-formatスキルの議事録フォーマットに従い、
決定事項とアクションアイテムを明確にしてください。
commands/email.md
---
description: ビジネスメールを作成(例: /biz:email 提案書送付のご連絡)
---
email-writerエージェントを使って以下のメールを作成してください: $ARGUMENTS
件名と本文を出力してください。
パターン4:データアナリスト向け「分析・レポート自動化プラグイン」
こんな人向け: データ分析・レポート作成・ダッシュボード設計を効率化したいアナリスト
できること:
-
/data:analyze [ファイル]でCSV/Excelを自動分析 - 分析レポートを自社フォーマットで自動生成
- Pythonコードのレビューとベストプラクティス適用
ディレクトリ構成:
data-analyst-plugin/
├── .claude-plugin/plugin.json
├── agents/
│ ├── data-analyst.md
│ └── report-writer.md
├── skills/
│ ├── analysis-standards/
│ │ └── SKILL.md
│ └── report-format/
│ └── SKILL.md
└── commands/
├── analyze.md
└── report.md
.claude-plugin/plugin.json
{
"name": "data",
"version": "1.0.0",
"description": "データアナリスト向け分析・レポート自動化プラグイン",
"author": { "name": "Your Name" }
}
skills/analysis-standards/SKILL.md
---
name: analysis-standards
description: Use when analyzing data, writing Python/SQL code for analysis,
or interpreting analytical results.
---
# データ分析規約
## 使用ツール
- Python: pandas, numpy, matplotlib, seaborn
- SQL: BigQuery(標準SQL)
- 可視化: Plotly推奨(インタラクティブ)
## 分析の進め方
1. データ概観(shape, dtypes, missing values)
2. 基本統計量(describe)
3. 分布確認(ヒストグラム、外れ値)
4. 相関分析
5. 仮説検証
## コーディング規約(Python)
- 変数名: snake_case
- DataFrameは`df_`プレフィックス(例: `df_sales`)
- 関数には必ずdocstring
- マジックナンバーは定数に
## 外れ値の扱い
- IQR法(1.5倍ルール)を基本とする
- 除外した場合は必ず理由をコメント
## よく使うスニペット
```python
# 欠損値確認
df.isnull().sum() / len(df) * 100
# 外れ値確認(IQR)
Q1, Q3 = df[col].quantile([0.25, 0.75])
IQR = Q3 - Q1
outliers = df[(df[col] < Q1 - 1.5*IQR) | (df[col] > Q3 + 1.5*IQR)]
```
skills/report-format/SKILL.md
---
name: report-format
description: Use when writing data analysis reports, dashboards specs,
or any document summarizing analytical findings.
---
# 分析レポートフォーマット
## レポート構成
1. エグゼクティブサマリー(3行で要約)
2. 分析背景・目的
3. データ概要(期間・件数・出所)
4. 主要な発見(数字で示す、グラフ参照)
5. 考察・インサイト
6. 推奨アクション(優先度付き)
7. 付録(詳細データ・分析コード)
## 数字の表記
- 1,000以上はカンマ区切り
- 比率は小数点1桁(例: 23.4%)
- 前年比は必ずセット(例: 売上120億円(前年比+15%))
## グラフの選び方
- 時系列: 折れ線
- 構成比: 円グラフ(5要素以下)or 積み上げ棒
- 比較: 棒グラフ
- 相関: 散布図
agents/data-analyst.md
---
name: data-analyst
description: Use when analyzing CSV/Excel data, writing analysis code,
or interpreting statistical results.
skills:
- analysis-standards
tools: Read, Write, Bash
model: sonnet
---
あなたはデータ分析専門エージェントです。
## 分析プロセス
1. データを読み込み概観を確認
2. analysis-standardsに従って段階的に分析
3. 発見した洞察を箇条書きで整理
4. 次の分析ステップを提案
## 出力形式
**データ概要**: 行数・列数・期間
**主要な発見**:
- (数字を必ず含む)
**推奨次ステップ**:
1.
agents/report-writer.md
---
name: report-writer
description: Use when writing analysis reports, summarizing findings,
or creating executive-level data summaries.
skills:
- report-format
- analysis-standards
tools: Read, Write
model: opus
---
あなたはデータレポート作成専門エージェントです。
## 執筆原則
- 数字は必ず文脈とセットで提示する
(「売上が増えた」→「売上が前年比+23%増加した」)
- 専門用語は注釈付き
- 推奨アクションは優先度順に
- エグゼクティブサマリーは3行で理解できるように
commands/analyze.md
---
description: データファイルを分析(例: /data:analyze sales_2025.csv)
---
data-analystエージェントを使って以下を分析してください: $ARGUMENTS
analysis-standardsスキルの手順に従い、段階的に分析を実行してください。
commands/report.md
---
description: 分析結果をレポート化(例: /data:report 売上分析の結果をまとめて)
---
report-writerエージェントを使って以下の分析結果をレポートにまとめてください: $ARGUMENTS
report-formatスキルの構成に従い、Markdown形式で出力してください。
パターン5:フリーランス・個人事業主向け「業務管理プラグイン」
こんな人向け: 見積もり・請求・クライアント管理を効率化したいフリーランス
できること:
-
/freelance:estimate [作業内容]で見積書のドラフト生成 - 自分の単価・稼働条件をSkillに登録
- 過去案件の振り返りと次のアクション整理
ディレクトリ構成:
freelance-plugin/
├── .claude-plugin/plugin.json
├── agents/
│ ├── business-manager.md
│ └── client-communicator.md
├── skills/
│ ├── my-rates/
│ │ └── SKILL.md
│ └── client-format/
│ └── SKILL.md
└── commands/
├── estimate.md
├── invoice.md
└── review.md
.claude-plugin/plugin.json
{
"name": "freelance",
"version": "1.0.0",
"description": "フリーランス向け業務管理・クライアント対応自動化プラグイン",
"author": { "name": "Your Name" }
}
skills/my-rates/SKILL.md
---
name: my-rates
description: Use when creating estimates, invoices, or discussing
project pricing and work conditions.
---
# 自分の単価・稼働条件(ここを自分の情報に書き換える)
## 基本単価
| 作業種別 | 単価 |
|---------|------|
| Webサイト制作(デザイン込み) | 30万円〜 |
| LP制作 | 15万円〜 |
| システム開発 | 月80万円 |
| コンサルティング | 3万円/時間 |
## 稼働条件
- 稼働可能時間: 平日 10:00〜19:00
- リモートのみ(出社不可)
- 最低契約期間: 1ヶ月
- 支払サイト: 月末締め翌月末払い
## 見積もりの考え方
- デザイン修正: 2回まで無料、以降1万円/回
- 仕様変更: 工数増加分は別途見積もり
- 急ぎ対応(3日以内納品): 通常料金×1.5倍
## 断る基準
- 予算が基本単価の半額以下
- 仕様が未確定のまま着手を求める
- 著作権を全て譲渡しろと言う
skills/client-format/SKILL.md
---
name: client-format
description: Use when communicating with clients — writing emails,
estimates, invoices, or project reports.
---
# クライアント向けフォーマット
## 見積書の構成
1. 件名(例: Webサイト制作 御見積書)
2. 有効期限(発行日より30日)
3. 作業内容・工数・単価の表
4. 合計金額(税抜・税込)
5. 支払条件
6. 備考(含まれないもの、前提条件)
## 請求書の構成
1. 件名・請求番号
2. 請求日・支払期限
3. 明細(作業内容・金額)
4. 合計金額
5. 振込先
## コミュニケーション原則
- レスポンスは24時間以内(営業日)
- 良い報告より悪い報告を早く
- 変更は必ずメールで文書化
- 曖昧な指示は必ず確認してから着手
agents/business-manager.md
---
name: business-manager
description: Use when creating estimates, invoices, project planning,
or reviewing business performance as a freelancer.
skills:
- my-rates
- client-format
tools: Read, Write
model: sonnet
---
あなたはフリーランス業務管理専門エージェントです。
## 見積もり作成の原則
1. 作業内容を細かく分解してから積み上げ
2. バッファ20%を必ず含める
3. 「含まないもの」を明記してスコープクリープを防ぐ
4. my-ratesの断る基準に該当する場合は警告を出す
## 振り返りの観点
- 実際の工数 vs 見積もり工数
- クライアントの満足度(推測)
- 次回の単価見直し提案
agents/client-communicator.md
---
name: client-communicator
description: Use when drafting emails to clients, handling difficult
requests, or preparing status reports.
skills:
- client-format
- my-rates
tools: Read, Write
model: sonnet
---
あなたはクライアントコミュニケーション専門エージェントです。
## メール作成の原則
- 結論から書く
- 依頼事項は番号付きリストで明確に
- 期日は具体的な日付で(「来週」はNG)
- 断る場合も代替案をセットで提案
## 難しい状況への対処
- 追加要望: スコープ確認→工数見積もり→提案
- 支払遅延: 丁寧だが毅然と期日確認
- クレーム: 謝罪→事実確認→対応策の順
commands/estimate.md
---
description: 見積書を作成(例: /freelance:estimate LPデザイン制作)
---
business-managerエージェントを使って以下の見積書を作成してください: $ARGUMENTS
my-ratesスキルの単価を基に、Markdown形式で見積書を出力してください。
commands/invoice.md
---
description: 請求書を作成(例: /freelance:invoice 3月分 Webサイト制作 30万円)
---
business-managerエージェントを使って以下の請求書を作成してください: $ARGUMENTS
client-formatスキルの請求書フォーマットに従って出力してください。
commands/review.md
---
description: 案件振り返り(例: /freelance:review 〇〇社LP案件 工数オーバーした)
---
business-managerエージェントを使って以下の案件を振り返ってください: $ARGUMENTS
学んだこと・次回への改善点・単価見直しの必要性を整理してください。
自分のプラグインを作る手順
サンプルを参考に、自分版を作るときの流れをまとめる。
Step 1:業務を書き出す(10分)
まず、繰り返しやっている業務をリストアップする。
自分の繰り返し業務:
□ 週次レポートの作成
□ コードレビューのコメント
□ クライアントへの進捗メール
□ 競合調査とまとめ
□ 〇〇のチェックリスト確認
Step 2:自動化できるものを選ぶ(5分)
以下の基準で優先順位をつける。
| 優先度 | 条件 |
|---|---|
| 高 | 週3回以上、かつ毎回30分以上かかる |
| 中 | 週1回以上、かつ毎回15分以上かかる |
| 低 | 月1〜2回 or 5分以内で終わる |
Step 3:Skillに知識を書き込む(30分〜)
Skillは「AIへの引き継ぎ書」にあたる。以下の4点を書く。
# Skillに書くべきこと
## 1. 自分のルール・判断基準
「こういう時はこうする」という暗黙知を言語化
## 2. フォーマット・テンプレート
よく使うフォーマットをそのまま貼る
## 3. 専門用語・社内用語の説明
外部に説明するとき使う言葉の定義
## 4. NGリスト
「やってはいけないこと」を明示
Step 4:Agentに役割を与える(15分)
---
name: [役割名]
description: [いつ呼ばれるか — Claudeが自動判断に使う]
skills:
- [使うスキル名]
tools: [Read, Write, Bash, WebSearch など]
model: sonnet # 通常はsonnet、複雑な作業はopus
---
あなたは[役割]専門エージェントです。
## 役割
[1〜3文で何をする人か]
## プロセス
[作業の手順を箇条書き]
## 出力形式
[何をどういう形で返すか]
Step 5:Commandで呼び出しやすくする(5分)
---
description: [説明 — /コマンド名 で何が起きるか]
---
[エージェント名]エージェントを使って $ARGUMENTS を処理してください。
Step 6:テストして調整する
# ローカルでテスト(インストール不要)
claude --plugin-dir ./my-plugin
# テスト用のプロンプト
> /my-plugin:my-command テスト入力
うまく動かない場合は、以下を順に試してみてほしい。
- Skillの
descriptionをより具体的に書き直す - Agentの指示をより明確にする
- モデルを
opusに変更してみる
よくある質問
Q: Skillのdescriptionはどう書けばいい?
Claudeが「このSkillを使うべきか」を判断するために読むフィールドになる。「いつ・何のために使うか」を具体的に書くとよい。
# NG(曖昧)
description: プロジェクトの情報
# OK(具体的)
description: Use when discussing project scope, pricing,
technical stack, or making architecture decisions.
Q: modelはsonnetとopusどう使い分ける?
| sonnet | opus |
|---|---|
| 調査、レビュー、軽い文書 | 提案書、設計、複雑な推論 |
| 速い・安い | 遅い・高い(でも賢い) |
迷ったらまずsonnetで試して、品質が足りなければopusに切り替えるのが効率的。
Q: プラグインをチームで共有するには?
GitHubにpushして、チームメンバーに以下を実行してもらうだけで済む。
claude plugin install your-github/your-plugin-name
Q: 既存の.claude/設定との違いは?
.claude/agents/などはプロジェクトローカルな設定として機能する。プラグインにすると以下のメリットがある。
- オン・オフが簡単(
claude plugin enable/disable) - チームやGitHubで共有できる
- 複数プロジェクトで再利用できる
Q: plugin.jsonは必須?
省略可能。省略した場合、Claude Codeがcommands/、agents/、skills/ディレクトリを自動検出する。明示的にカスタムパスを指定したい場合や、メタ情報を記載したい場合に使う。
まとめ
Claude Codeのプラグイン機能を使えば、自分の業務ノウハウをAIエージェントとして封じ込め、ワンコマンドで呼び出せる。
今日やること:
- 繰り返しやっている業務を1つ選ぶ
- この記事のサンプルをコピーしてベースを作る
- Skillに自分のルール・知識を書き込む
-
claude --plugin-dir ./my-pluginでテスト
最初の1つが動くと、あとは雪だるま式に増やせる。ぜひ自分だけの業務プラグインを作ってみてほしい。
