Save Insight
Productivitysave-insightSave Insight is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Capture learnings from completed work for future reference
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/save-insight/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/save-insight, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Capture what you learned from completing work. This is the "compound" step—making future similar work easier.
Arguments
$WORK_COMPLETED: What did you just complete? (project milestone, tricky problem, meeting, workflow improvement, etc.)
Process
1. Reflection Questions
Ask the user (or extract from recent work context):
-
What was the situation?
- Original goal or challenge
- Why it was harder than expected (if applicable)
-
What approach worked?
- Strategy or tactic used
- Key decisions made
-
What would you do differently?
- Gotchas encountered
- Better approaches discovered late
-
What's reusable?
- Patterns that apply elsewhere
- Mental models that help
2. Create or Update Learning Note
Store in: 06-Resources/Learnings/[Category]_Learnings.md
Categories:
Working_Preferences- How you like to work, communication style, tool preferencesMistake_Patterns- Common errors to avoid, with triggers and corrections
Create new category files as needed for domain-specific learnings.
3. Learning Entry Format
Append to the appropriate file:
---
## [Short Title] — [Date]
**Context:** [1 sentence on what you were doing]
**Challenge:** [What was tricky or non-obvious]
**What Worked:**
[The approach that succeeded]
**Key Insight:**
> [The memorable takeaway—something you'd tell past-you]
**See Also:** [Related notes if any]
4. Cross-Link (Optional)
If the learning relates to:
- A person → Add to their person page
- A project → Add link in project's note
- A recurring workflow → Update relevant template
Output
- Ask reflection questions (or extract from context)
- Create/update the appropriate learning file
- Suggest any cross-links
- Confirm saved
Philosophy
"The palest ink is better than the best memory." — Chinese proverb
This isn't documentation for others—it's a gift to future-you. Be specific. Include the gotcha. Make it searchable.