Agent Design Review

AIエージェントの仕様書・要件定義・設計ドキュメントをレビューするスキル。ユーザーが「仕様書を見て」「設計レビューして」「これで問題ないか確認して」「エージェント設計のフィードバックほしい」などと言ったとき、またはエージェント設計に関する判断を求められたときに必ず使う。ハーネス設計・ツール分類・コンテキスト設計・マルチエージェント構成・陳腐化リスクの5軸で問題を検出し、具体的な改善案を返す。

5 stars 1 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add nekoai-lab/claude-skills --skill agent-design-review
Manual install
git clone --depth 1 https://github.com/nekoai-lab/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/agent-design-review ~/.claude/skills/agent-design-review

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# AIエージェント設計レビュースキル

## 目的

ユーザーが提出した仕様書・要件定義・設計メモを、  
以下の5つの判断軸でレビューし、問題点と改善案を返す。

レビューは「動くかどうか」ではなく「無駄がないか・壊れにくいか・コストが最適か」を基準にする。

---

## レビューの進め方

### ステップ1:入力を確認する

ユーザーが提出したドキュメントから以下を把握する。

- エージェントの数と役割
- 使用するツールのリスト
- システムプロンプトの内容または概要
- エージェント間のデータの受け渡し方法(マルチエージェントの場合)
- 対象モデル(記載があれば)

情報が不足している場合は、レビューを始める前に不足項目を一度だけ質問する。

### ステップ2:5軸でレビューする

以下の順番で全軸をチェックする。問題がない軸はスキップせず「問題なし」と明示する。

### ステップ3:結果を返す

以下のフォーマットで返す。

```
## レビュー結果

### 軸① ツール設計
状態:[問題あり / 要確認 / 問題なし]
検出した問題:(あれば)
改善案:(あれば)

### 軸② 静的・動的の順序
...(以下同様)

## 優先度順の改善アクション
1. (最優先)
2. 
3. 
```

---

## 5つの判断軸と判定ルール

### 軸① ツール設計

**チェックする問い**
- 取り消せない操作(外部送信・削除・上書き・課金が発生する操作)がbashのまま実装されていないか
- ユーザー確認が必要な操作が専用ツールになっているか
- ログ・監査が必要な操作が専用ツールになっているか

**問題ありと判定する条件**
- 取り消せない操作がbashで実装されている
- 「なんでも bash で済ませる」設計になっている

**改善案の返し方**
- 専用ツール化すべき操作を列挙する
- 以下の形式で返す:

```
専用ツール化が必要な操作:
- [操作名]:理由(取り消せない / 確認が必要 / ログが必要)
```

---

### 軸② 静的・動的の順序

**チェックする問い**
- システムプロンプト・ツール定義(静的)が先に来ているか
- 会話履歴・ツール結果(動的)が後に来ているか
- セッション中にモデルを切り替える設計になっていないか
- セッション中にツールを動的に追加・削除する設計になっていないか

**問題ありと判定する条件**
- 動的な内容が静的な内容より前に配置されている
- セッション中のモデル切り替えが設計に含まれている
- ツールの動的追加・削除がある(tool searchを使わずに)

**改善案の返し方**
- 正しい順序を明示する
- コスト影響がある場合は「キャッシュが効かずコストが増大する可能性がある」と付記する

---

### 軸③ システムプロンプトの設計

**チェックする問い**
- システムプロンプトに複数タスクの詳細手順が詰め込まれていないか
- 現在のタスクに不要な指示が含まれていないか
- スキルファイルへの分離が検討されているか

**トークン数の目安**
- 200トークン以下:適切
- 200〜500トークン:要確認(内容による)
- 500トークン超:問題あり(分離を推奨)

**問題ありと判定する条件**
- 複数の異なるタスクの手順が一つのシステムプロンプトにある
Read the full skill on GitHub

Details

Skill name
agent-design-review
Path
agent-design-review/SKILL.md
Repo updated
27 September 2026

FAQ

What does the Agent Design Review skill do?

AIエージェントの仕様書・要件定義・設計ドキュメントをレビューするスキル。ユーザーが「仕様書を見て」「設計レビューして」「これで問題ないか確認して」「エージェント設計のフィードバックほしい」などと言ったとき、またはエージェント設計に関する判断を求められたときに必ず使う。ハーネス設計・ツール分類・コンテキスト設計・マルチエージェント構成・陳腐化リスクの5軸で問題を検出し、具体的な改善案を返す。

How do I install the Agent Design Review skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add nekoai-lab/claude-skills --skill agent-design-review. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Design Review popular?

It lives in nekoai-lab/claude-skills, which has 5 GitHub stars and 1 forks.

Related skills

Agent Ops Review

5

nekoai-lab/claude-skills

運用中・運用開始前のAIエージェントを「安全に運用できているか」の観点でレビューするスキル。隔離・監視・早期兆候・停止権限・タスク設計・エージェント間通信・認証情報・人の監督・開示の9軸で、実運用で事故になった箇所を検出する。「運用チェックして」「安全に動かせてる?」「本番に出して大丈夫か見て」「エージェントの運用レビュー」と言われたとき、またはエージェントを社内・本番で動かし始める直前・直後に必ず使う。仕様書・要件定義・設計ドキュメントのレビューは agent-design-review(設計側)を使う。本スキルは動いているもの・動かす直前のものを対象とする運用側。

AI, LLMs & Agents

Astro Marketing Site Launch

5

nekoai-lab/claude-skills

Astro等の静的マーケ/ブログサイトやLPを「検索・AI・回遊・モバイル・アクセシビリティ・コンバージョン・信頼」に強い状態で作る/監査するためのチェックリストと実装パターン。ユーザーが「新しいサイト/LPを作る」「ブログ/インサイト機能を追加する」「サイトのSEO/AIO/モバイル/アクセシビリティを見て」「公開前チェックして」などと言ったときに使う。SEO(JSON-LD/canonical/カテゴリ・タグ静的ページ)・AIO(llms.txt/RSS/sitemap/robots)・回遊(前後記事/関連記事/文脈CTA)・パフォーマンス(Core Web Vitals)・コンバージョン設計(CRO)・計測(GA4イベント/CV)・フォーム/スパム対策・法令/Cookie同意/外部送信規律・プライバシーポリシー・横はみ出しゼロ・ファビコン要件・セキュリティヘッダ・依存の落とし穴(@astrojs/sitemapのAstro4互換等)を含む。

Marketing, Sales & Business

Information Design

5

nekoai-lab/claude-skills

スライド、レポート、ダッシュボード、提案書の作成時に、情報をわかりやすく、比較しやすく、誤解なく伝えるための設計原則を適用する

Other

Workers AI

9

zllovesuki/cloudflare-agent-skills

Write Cloudflare Workers AI and AI Gateway code for model inference, prompts, streaming, token budgets, model selection, observability, and fallback design. Use when adding LLM, embeddings, summarization, classification, or generation to Workers.

AI, LLMs & Agents

Cdp Skills

5

realsigridjin/interview-copilot-with-skills

Claude Developer Platform Skills feature. Custom knowledge packages for agents, curated playbooks, and versioned expertise domains.

AI, LLMs & Agents

Table Design Advisor

9

shisuidata/ss-data-skills

Use when designing or reviewing a data warehouse table schema. Advises on warehouse layer, table grain, fact or dimension modeling, fields, primary key, partitioning, update strategy, lifecycle, naming, downstream usage, and data quality checks. 中文触发词:表设计、数仓建模、表结构审查、表粒度、分区设计。

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.