Read evaluations and reflections, then take concrete actions to improve
Turn raw journal observations into stable knowledge. This is the promotion step — read from journal/, distill into stable knowledge, promote to the right topic (self/, user/, domains/, etc.).
kb(action="search", query="evaluation", topic="self")
kb(action="search", query="reflection", topic="journal")
Read the most recent evaluation and any reflections since the last improvement pass.
From the evaluation, note:
For each target, choose the appropriate action:
| Problem | Action |
|---|---|
| Repeated mistakes | Store the correct pattern in self/ or domains/ so you find it next time |
| Missing user context | Store what you learned in user/ (preferences, patterns, context) |
| Inefficient tool use | Store a tool usage pattern in self/ (e.g., "always check X before Y") |
| Poor knowledge use | Review what's in the KB — reorganize, add missing tags, consolidate entries |
| Communication mismatch | Store communication preferences in user/ (verbosity, format, tone) |
| Knowledge gaps | Store the missing knowledge in the appropriate topic |
Always search before storing. The goal is to build up knowledge that prevents the same mistakes.
For changes that require user approval or that you're uncertain about, create a proposal:
kb(action="store", topic="self", title="Proposal: <description>", content="...", tags=["proposal", "<dimension>"])
Proposal format:
## Problem
<What's going wrong>
## Proposed change
<What to do about it>
## Expected impact
<Which dimension this should improve, and how>
## Status
Pending — awaiting user review
Use proposals for:
Act directly (without proposal) for:
After taking actions, record what you did:
kb(action="store", topic="self", title="Improvement: <date>", content="...", tags=["improvement", "<dimension>"])
Improvement format:
## Based on
<Link to evaluation and/or reflections that triggered this>
## Actions taken
- <Action 1: what you did and why>
- <Action 2: ...>
## Journal entries processed
- <List of journal/ entries that were promoted or addressed>
## Proposals created
- <Proposal title, or "none">
## Expected impact
<Which dimensions should improve>
The core job of this skill:
journal/ (written by self-reflect)self/ (written by self-evaluate)self/, user/, domains/, projects/restrict_to_workspace)Summarize: