Back to list
petbrains

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

FactorQuestion
ScopeHow much affected?
ConflictsFindings contradict?
Trade-offsSignificant 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