review-learnings

Audit learnings documents for actionability, specificity, completeness, and balance.

5|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/tomzx/agents --skill review-learnings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-learnings
Source: https://github.com/tomzx/agents/tree/main/skills/review-learnings
Command: npx skills add https://github.com/tomzx/agents --skill review-learnings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits a learnings document and reports findings across four categories: actionability, specificity, completeness, and balance, enabling targeted improvements.

Core Features & Use Cases

  • Actionability: identifies concrete actions, owners, and target dates.
  • Specificity & Completeness: evaluates observations for depth, technical relevance, and coverage of both positives and negatives.
  • Use Case: apply to a learnings document from a sprint or project to surface improvement opportunities and ensure they are actionable.

Quick Start

Provide a path to a learnings document and let the skill produce a structured review.

Frequently Asked Questions about review-learnings

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

FAQPage Schema
How do I audit my project learnings document for actionability?

Auditing a learnings document for actionability involves evaluating observations to identify concrete actions, assign owners, and set target dates. This skill reviews your file and reports findings to enable targeted process improvement.

What is a learnings audit and how does it improve knowledge management?

A learnings audit is a review process that assesses documentation across actionability, specificity, completeness, and balance. It improves knowledge management by surfacing improvement opportunities and ensuring they are actionable.

How do I review sprint learnings to ensure they are specific and complete?

Reviewing sprint learnings for specificity and completeness involves evaluating observations for depth and technical relevance while checking coverage of both positives and negatives. This skill produces a categorized report to guide improvements.

Does this audit tool work with learnings files stored in .sdlc/knowledge/learnings?

Yes, this audit tool works directly with learnings files located under .sdlc/knowledge/learnings or provided in context. It analyzes the document and outputs a structured review with improvement actions and owners.

What's the best way to turn project observations into actionable improvements?

Turning project observations into actionable improvements requires evaluating the documentation to identify concrete actions and owners. This skill audits your learnings file and produces a categorized report to drive process improvement.

When should I not use an automated learnings audit?

An automated learnings audit is not suitable when your documentation lacks structured observations or defined owners. The audit requires existing learnings text to evaluate across actionability, specificity, completeness, and balance.