Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

prompt-improver

verified

Collect feedback on task completion to improve prompts, CLAUDE.md, and skills. Use when the user says "improve prompts", "analyze feedback", "reflect on task", "/improve", or when Stop hook triggers for feedback collection. Enables continuous improvement loop for Claude Code configurations.

View on GitHub

Marketplace

dev-tools-plugin

sizukutamago/dev-tools-plugin

Plugin

dev-tools-plugin

productivity

Repository

sizukutamago/dev-tools-plugin

skills/prompt-improver/SKILL.md

Last Verified

February 5, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/sizukutamago/dev-tools-plugin/blob/main/skills/prompt-improver/SKILL.md -a claude-code --skill prompt-improver

Installation paths:

Claude
.claude/skills/prompt-improver/
Powered by add-skill CLI

Instructions

# Prompt Improver

タスク完了時のフィードバックを収集・分析し、CLAUDE.md/SKILL/hooksの継続的改善を支援するスキル。

## 概要

```
┌─────────────────────────────────────────────────────────────┐
│                    自己改善ループ                            │
│                                                             │
│   タスク実行 → Stop hook → フィードバック収集 → 保存         │
│                                ↓                            │
│   改善適用 ← 改善提案生成 ← パターン分析 ← 蓄積データ        │
└─────────────────────────────────────────────────────────────┘
```

## アーキテクチャ

```
┌────────────────────────────────────────────────────────┐
│                  prompt-improver                        │
├──────────────┬─────────────────┬───────────────────────┤
│  Collection  │    Analysis     │    Recommendation     │
│  (自動)       │   (/improve)    │   (インタラクティブ)    │
├──────────────┼─────────────────┼───────────────────────┤
│ Stop hook    │ analyze_        │ generate_             │
│ collect_     │ feedback.sh     │ improvements.sh       │
│ feedback.sh  │                 │ recommend_            │
│              │                 │ structure.py          │
└──────────────┴─────────────────┴───────────────────────┘
```

| Part | トリガー | 入力 | 出力 |
|------|---------|------|------|
| Collection | Stop hook(自動) | トランスクリプト | feedback/*.yaml |
| Analysis | `/improve` | feedback/*.yaml | パターンレポート |
| Recommendation | インタラクティブ | パターンレポート | 改善提案・適用 |

---

## Part 1: フィードバック収集(Collection)

Stop hookでタスク完了時に**条件を判断して**自動収集。

#### 収集条件(いずれかに該当する場合のみ)

- Write/Edit/Bashで実質的なコード変更を行った
- スキル(/hearing, /architecture, /api等)を使用した
- ユーザーから修正指示・不満・指摘があった
- エラーや予期しない失敗が発生した
- 3ステップ以上の複雑なタスクを実行した

#### スキップ条件(以下のみの場合は収集しない)

- 質問への回答・説明のみ
- git status/Read/Glob等の閲覧操作のみ
- 1-2ターンの軽微な対話
- 設定確認や情報表示のみ

#### 収集する情報

1. タスクの要約と結果(成功/部分成功/失敗)
2. 問題点と関連するプロンプト/SKILLへの紐付け
3. ユーザーからの指摘(あれば)
4. 改善の示唆

---

## Part 2: フィードバック分析(Analysis)

`/improve` コマンドで起動。蓄積されたフィードバックをパターン分析。

### 統計・パターン分析

```bash
# 統計表示
./scripts/analyze_feedback.sh --stats

# パターン分析
./scripts/analy

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
6310 chars