← Back to list

self-improve
by petbrains
Document-Driven Development framework for Claude Code — structured specs, TDD cycles, feedback loops, and skills system
⭐ 6🍴 1📅 Jan 24, 2026
SKILL.md
name: self-improve description: Transforms simple user requests into enriched descriptions with traceable findings. Use when interpreting vague user intent, preparing context for agent generation, or synthesizing actionable insights from available project context. allowed-tools: Read
Self-Improve
Transform user intent into actionable understanding.
Core Function
User Intent + Available Context → Enriched Description
Behavior
- Specific intent → focused interpretation, targeted findings
- Vague intent → broader scan, note what clarification needed
Process
1. Interpret Intent
Extract from user request:
- Action: What to do
- Subject: What to affect
- Implicit: What's assumed but not said
2. Synthesize Findings
Connect intent with relevant context. Each finding:
[Discovery] → [source]
Requirements: traceable, relevant, actionable.
3. Assess Complexity
| Factor | Question |
|---|---|
| Scope | How much affected? |
| Conflicts | Findings contradict? |
| Trade-offs | Significant choices? |
Any factor high → flag for deeper analysis.
Output
## Intent
[Interpreted user intent]
## Findings
1. [Discovery] → [source]
2. [Discovery] → [source]
3. [Discovery] → [source]
## Complexity
[Simple | Needs analysis: scope/conflicts/trade-offs]
Score
Total Score
75/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
✓説明文
100文字以上の説明がある
+10
○人気
GitHub Stars 100以上
0/15
✓最近の活動
1ヶ月以内に更新
+10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon

