reflect

Distill session learnings into AGENTS.md guideline improvements.

13|2|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/rstacruz/agentic-toolkit --skill reflect-rstacruz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/rstacruz/agentic-toolkit/tree/main/skill/atk/reflect
Command: npx skills add https://github.com/rstacruz/agentic-toolkit --skill reflect-rstacruz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distill session learnings into concrete improvements for skills and AGENTS.md, helping teams learn from experiences and refine guidelines.

Core Features & Use Cases

  • Session review: Analyze completed work to identify recurring questions, gaps, and opportunities for improvement.
  • Guideline enhancement: Propose edits to AGENTS.md and AGENTS.local.md to prevent repetition and missteps.
  • Knowledge capture: Update AGENTS.md with structured patterns and decisions to guide future agents.

Quick Start

Review a recent session, identify at least three concrete improvements, and draft corresponding AGENTS.md edits to implement them.

Frequently Asked Questions about reflect

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

FAQPage Schema
How do I turn session learnings into actionable improvements for AGENTS.md?

To turn session learnings into actionable improvements, analyze completed work to identify recurring questions and gaps, then distill these findings into concrete guideline edits for AGENTS.md. This structured review process captures knowledge to guide future agent behavior across sessions.

What is the best way to capture knowledge from a completed project session?

The best way to capture knowledge from a completed session is to review the work, identify at least three concrete improvements, and draft corresponding AGENTS.md edits. This updates project guidelines with structured patterns and decisions to prevent future missteps.

How do I refine project guidelines to prevent repeating the same mistakes?

Refine project guidelines to prevent repeating mistakes by proposing targeted edits to AGENTS.md and AGENTS.local.md. Analyzing recent sessions helps identify recurring gaps and apply structured patterns that guide future agents away from known missteps.

Can I use a structured prompt to update AGENTS.md automatically after a session?

Yes, you can use structured prompts to update AGENTS.md automatically after a session. The process requires these structured prompts to distill session learnings and draft corresponding documentation updates for guideline refinement.

What are the limitations of using session reviews for guideline enhancement?

Limitations of using session reviews for guideline enhancement include the requirement for structured prompts and manual documentation updates. The process depends on analyzing completed work to identify gaps, meaning unstructured or poorly documented sessions may yield less actionable improvements.