# Reflect

> Review a completed or long-running task for reusable workflow lessons and propose focused skill improvements. Use only when the user asks to reflect or capture lessons.

- Skill: `vaibtan/reflect` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add vaibtan/reflect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vaibtan/reflect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: Vaibtan (https://skillmd.com/u/vaibtan)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/vaibtan/reflect

---


# Reflect

Use only the current task, repository artifacts, and task or memory records the user has placed in scope. Do not scan guessed transcript directories or unrelated conversations.

1. Reconstruct the task timeline from requests, decisions, tool use, failures, corrections, and verification.
2. Separate one-off facts from reusable agent behavior. A lesson earns a skill change only when it changes a future decision and cannot be enforced more reliably in code, tests, or configuration.
3. For a complex task, use independent `deep`, `general`, and `fast` review lenses for judgment, tooling, and divergent interpretation. Give them the same evidence and no proposed fix.
4. Accept, reject, or backlog each suggestion with a concrete reason. Prefer editing an existing skill over adding a new one.
5. When the user authorized updates, use `$skill-creator`, validate the affected skill, and report the exact behavior changed. Otherwise return a reviewable proposal without modifying files.

Do not update Codex memory unless the user explicitly asks for a memory update.