Menu
When you encounter a failure, correction, or new pattern, write a learning and optionally propose a skill.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Complete reference for the factory CLI — all commands, arguments, options, and usage. Use when an agent needs to invoke factory commands, check correct syntax, or understand available options.
When and how to write a human-action-needed entry to memory/{agent}/needs.md. Agents write these entries when they hit blockers that only a human can resolve.
How the factory workspace is organized and what each directory means.
What to examine during a reflection pass and how to write observations to memory/{agent}/needs.md.
When and how to write scenario holdouts for factory verification.
How to integrate scenario evaluation into verification reports.
| name | self-improvement |
| description | When you encounter a failure, correction, or new pattern, write a learning and optionally propose a skill. |
Write a learning to the appropriate directory:
learnings/failures/{YYYY-MM-DD}-{project}-{summary}.md for failureslearnings/corrections/{YYYY-MM-DD}-{summary}.md for human correctionslearnings/discoveries/{YYYY-MM-DD}-{summary}.md for new patternsInclude: what happened, what you expected, what actually occurred, what you learned, what should change.
If the learning suggests a reusable skill (something that would help ANY agent in similar future situations):
skills/proposed/{skill-name}/SKILL.mdIf you surface friction, tooling limitations, or architectural gaps during work, write an observation entry to memory/{your-agent-name}/needs.md using the human-action-needed skill (category: observation). This makes the observation durable — prose in your response text is ephemeral and the factory cannot act on it. The kernel post-run pass automatically promotes observation entries from needs.md to specs/factory-internal/ for structured operator triage via factory triage.
Update your daily log with a brief note about the learning.
skills/shared/ directly — always propose via skills/proposed/skills/shared/ first.