summary-generator

Generate Socratic-style lesson summaries into .summary.md companion files.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/92Bilal26/physical-ai-textbook --skill summary-generator-92bilal26
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: summary-generator
Source: https://github.com/92Bilal26/physical-ai-textbook/tree/main/.claude/skills/summary-generator
Command: npx skills add https://github.com/92Bilal26/physical-ai-textbook --skill summary-generator-92bilal26

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates concise, scannable summaries for educational lessons by extracting the essential learning elements through Socratic questioning. Summaries support quick review for students and just-in-time reference during practice.

Core Features & Use Cases

  • Socratic extraction process using 6 questions to capture Core Concept, Key Mental Models, Critical Patterns, AI Collaboration Keys, Common Mistakes, and Connections
  • Produces a companion .summary.md file alongside the original lesson
  • Helps learners refresh understanding quickly and aids instructors in review
  • Adaptable to lesson complexity, updating summaries as content evolves

Quick Start

Generate a summary for a lesson file (e.g., book-source/docs/05-Python/17-intro/01-variables.md) to create a companion file named 01-intro.summary.md in the same directory.

Frequently Asked Questions about summary-generator

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

FAQPage Schema
How do I generate a concise summary from a lesson markdown file?

Generate a summary by running the Skill on your lesson markdown file to produce a companion `.summary.md` document. The Skill extracts essential learning elements through Socratic questioning, outputting structured sections: Core Concept, Key Mental Models, Critical Patterns, AI Collaboration Keys, Common Mistakes, and Connections.

What is Socratic summarization and how does it help with lesson review?

Socratic summarization uses six targeted questions to distill lesson content into scannable, essential elements. It supports quick review for students and just-in-time reference during practice, helping learners refresh understanding without re-reading full materials.

Can I use lesson summaries across different proficiency levels?

Yes, the Skill produces summaries adaptable to lesson complexity and varying learner proficiency. The structured template format—Core Concept through Connections—enables quick comprehension regardless of background, making summaries useful for both beginners and advanced learners.

How do I keep summaries up to date as lesson content evolves?

Regenerate the summary when lesson content changes. The Skill produces a new `.summary.md` companion file, allowing you to update summaries as content evolves and maintain alignment between lessons and their reference summaries.

What markdown structure does the summary output follow?

The summary output uses a Markdown template with six predefined sections: Core Concept, Key Mental Models, Critical Patterns, AI Collaboration Keys, Common Mistakes, and Connections. This structure adheres to length guidelines and anti-pattern constraints for consistency.