/mcs-retro — Post-Session Retrospective

Capture and classify development session learnings into structured markdown files.

10|3|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/microsoft/MCS-Agent-Builder --skill mcs-retro-post-session-retrospective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /mcs-retro — Post-Session Retrospective
Source: https://github.com/microsoft/MCS-Agent-Builder/tree/main/.claude/skills/mcs-retro
Command: npx skills add https://github.com/microsoft/MCS-Agent-Builder --skill mcs-retro-post-session-retrospective

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @google/generative-ai, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of capturing, classifying, and integrating learnings from development sessions, preventing knowledge loss and improving future builds.

Core Features & Use Cases

  • Automated Learning Capture: Gathers errors, workarounds, discoveries, and performance observations from build/eval/fix sessions.
  • Intelligent Classification: Categorizes learnings into REPEAT, NEW, CORRECTION, ENHANCEMENT, TOOLING_GAP, SOLUTION_PATTERN, or DECISION_OUTCOME.
  • Knowledge System Integration: Updates local learning files and indexes, and can suggest improvements to tooling.
  • Use Case: After a complex agent build session that encountered several unexpected errors and required manual workarounds, run this Skill to log these issues, classify them, and ensure they are recorded for future reference, potentially identifying a new solution pattern or a gap in existing tools.

Quick Start

Run the mcs-retro skill to capture and classify learnings from the current session.

Frequently Asked Questions about /mcs-retro — Post-Session Retrospective

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

FAQPage Schema
How do I capture learnings from a development session to prevent knowledge loss?

You can capture and classify development session learnings by analyzing build errors, eval failures, and manual workarounds. This updates local markdown files and index.json, integrating observations into a structured knowledge system to prevent knowledge loss.

What is the best way to classify build errors and manual workarounds for continuous improvement?

The best way to classify build errors and workarounds is to categorize them as REPEAT, NEW, CORRECTION, ENHANCEMENT, TOOLING_GAP, SOLUTION_PATTERN, or DECISION_OUTCOME. This intelligent classification cross-references against a solution library to enrich the data for continuous improvement.

How does automated retrospective classification integrate with existing knowledge management files?

Automated retrospective classification integrates with knowledge management by updating local markdown learning files and index.json. It cross-references session observations against a solution library and cache to ensure enriched classification and structured knowledge system integration.

Can I use this retrospective tool to identify tooling gaps from agent build sessions?

Yes, you can use this retrospective tool to identify tooling gaps from agent build sessions. It classifies items under the TOOLING_GAP category and suggests improvements based on the manual workarounds and build errors encountered during the development session.

Does the continuous improvement classification system depend on specific generative AI libraries?

Yes, the continuous improvement classification system depends on the @google/generative-ai library. This dependency provides the underlying reasoning required to analyze build session learnings and classify them into structured categories like SOLUTION_PATTERN or DECISION_OUTCOME.

When should I run a post-session retrospective to log solution patterns and decision outcomes?

You should run a post-session retrospective immediately after a complex agent build session that encountered unexpected errors or required manual workarounds. This logs issues, classifies them, and records solution patterns and decision outcomes for future reference.