context-reflect

Generates evidence-based retrospectives of completed tasks from conversation and tool-call context.

Updated Jul 4, 2025
One-click install
npx skills add https://github.com/milespossing/nixdots --skill context-reflect-milespossing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: context-reflect
Source: https://github.com/milespossing/nixdots/tree/main/modules/agents/_skills/context-reflect
Command: npx skills add https://github.com/milespossing/nixdots --skill context-reflect-milespossing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After finishing a task, it is hard to reconstruct what actually happened: which skills were used, where time and tokens went, what dead ends occurred, and how the prompt could have been better. This Skill produces a structured, evidence-based retrospective from the visible conversation and tool-call history. ## Core Features & Use Cases - Trace Reconstruction: Rebuilds the phases of work, skills loaded, files read, commands run, and validation performed from visible context. - Cost Analysis: Ranks longest tasks and token-heavy hotspots using exact telemetry when available or qualitative evidence when not, without fabricating numbers. - Actionable Improvements: Answers focus questions about missing or misleading information and outputs a copyable improved prompt plus a next-time checklist. - Use Case: After a long debugging session, ask for a retrospective to learn which searches were wasted, what context should have been provided up front, and how to prompt better next time. ## Quick Start Ask the agent to run context-reflect on the task we just finished and summarize the dead ends, token hotspots, and a better prompt for next time.

Frequently Asked Questions about context-reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a retrospective of what an AI agent did on a task?▼

Invoke context-reflect immediately after the task completes while the conversation and tool-call history are still visible. The skill reconstructs phases of work, skills used, files touched, and validation performed, then outputs a structured retrospective report.

How can I find out which tasks consumed the most tokens in a session?▼

The retrospective ranks token-heavy hotspots using exact token accounting if it is visible in context. When telemetry is unavailable, it uses qualitative proxies like large file reads, long command output, broad searches, and repeated diffs, and labels them high, medium, or low.

Can context-reflect analyze a task from a previous session?▼

No, it only works when the previous task is in the visible context. If the history is gone, you must supply a transcript, summary, branch, PR, or artifact before the skill can reflect, and it will not invent missing history.

When should I not use a post-task reflection skill?▼

Do not use it for planning before work begins, since it is strictly a retrospective tool. It is also unsuitable when no completed task exists in context or when you need precise billing-level token metrics that the environment does not expose.

How does the retrospective avoid inaccurate token or time estimates?▼

It explicitly forbids fabricating numbers. If exact timing or token telemetry is absent, it states that once in the evidence basis and falls back to relative rankings with qualitative evidence such as repeated loops, large reads, or long-running tools.