insight-retro

Generates structured post-implementation retrospectives covering blast radius, documentation audits, and tech debt.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill insight-retro-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: insight-retro
Source: https://github.com/allemaar/open-skills/tree/main/skills/insight-retro
Command: npx skills add https://github.com/allemaar/open-skills --skill insight-retro-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After shipping significant implementation work, teams lose track of what changed, documentation drifts out of sync, reusable patterns go uncaptured, and tech debt accumulates silently. This Skill runs a structured retrospective that maps the blast radius, audits documentation accuracy, extracts reusable patterns, and inventories tech debt before that knowledge is lost. ## Core Features & Use Cases - Blast Radius Mapping: Builds a manifest of every package, app, and file created, modified, or deleted, grouped by package, using implementation plans, walkthroughs, and git diffs. - Documentation Audit: Checks READMEs, sidecar files, changelogs, and barrel exports against actual code, reporting findings by severity (MISLEADING, STALE, MISSING, ACCURATE) with cited evidence. - Pattern & Skill Extraction: Identifies reusable patterns with reuse-potential ratings and recommends creating or updating skills and knowledge items, checking the skill index first to avoid duplicates. - Use Case: After merging a large multi-package feature, run /retro to get a report covering what changed, which docs are now stale, what patterns deserve codification, difficulty analysis, and a prioritized tech debt inventory with follow-up actions. ## Quick Start Run /retro after completing a significant implementation to generate a full retrospective report of changes, documentation gaps, and follow-up work.

Frequently Asked Questions about insight-retro

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

FAQPage Schema
How do I run a retrospective after completing a large implementation?

Run /retro after shipping significant work. The skill maps the blast radius from your implementation plan and git diff, audits documentation, extracts reusable patterns, and compiles a report with tech debt and follow-up actions.

What does a post-implementation retrospective report include?

The report covers seven sections: blast radius summary, extracted patterns with recommended actions, documentation audit by severity, knowledge and skill updates, difficulty log, tech debt inventory, and gate status for committed work.

Does the retrospective skill fix the issues it finds?

No, the retro is observation only. It reports documentation gaps, tech debt, and missing patterns with concrete recommended actions, but all fixes are handled as separate follow-up tasks.

How does the skill avoid proposing duplicate skills?

It checks the skill index first before proposing any new skill. Existing skills that cover a pattern are marked as no-action, incomplete ones get specific gap notes, and only genuinely uncovered domains get new skill proposals.

When should I use insight-skill-gap instead of a full retrospective?

Use insight-skill-gap when your goal is specifically to identify new or updated skills. The full /retro is broader, covering blast radius, documentation audits, difficulty analysis, and tech debt in addition to skill assessment.