aiskillstore/marketplace / skills/92bilal26/summary-generator
summary-generator
VerifiedThis skill should be used when generating lesson summaries for educational content. It extracts key concepts, mental models, patterns, and common mistakes from lesson markdown files using a Socratic extraction process. Use this skill when a lesson file needs a `.summary.md` companion file, or when reviewing/refreshing existing summaries.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.6 KB |
| skill-report.json | config | 19.0 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T16:29:36.511Z",
"slug": "92bilal26-summary-generator",
"source_url": "https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/summary-generator",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "5e437716ad3e24ed65b73a651345745b3e388fb8a14c443dfc3096294b1f063e",
"tree_hash": "4d563474857328bfee7a99defd9a65dff57e8b1031194e7ca1d9f24edfb614a5",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "summary-generator",
"description": "Generate concise lesson summaries from educational Markdown files using a structured Socratic extraction process.",
"summary": "Creates companion lesson summaries with core concepts, mental models, patterns, mistakes, and learning connections.",
"icon": "π¦",
"version": "1.0.1",
"author": "92Bilal26",
"license": "MIT",
"category": "documentation",
"tags": [
"lesson-summaries",
"education",
"markdown",
"socratic-analysis",
"study-notes"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
]
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All 14 static findings are Markdown backticks in prose, fenced templates, file-name examples, or educational snippets, not executable shell or Ruby code. No prompt injection, data exfiltration intent, or unauthorized command execution evidence was found in SKILL.md.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 3,
"line_end": 3
},
{
"file": "SKILL.md",
"line_start": 74,
"line_end": 97
},
{
"file": "SKILL.md",
"line_start": 97,
"line_end": 101
},
{
"file": "SKILL.md",
"line_start": 101,
"line_end": 123
},
{
"file": "SKILL.md",
"line_start": 123,
"line_end": 125
},
{
"file": "SKILL.md",
"line_start": 125,
"line_end": 131
},
{
"file": "SKILL.md",
"line_start": 131,
"line_end": 141
},
{
"file": "SKILL.md",
"line_start": 141,
"line_end": 147
},
{
"file": "SKILL.md",
"line_start": 147,
"line_end": 153
},
{
"file": "SKILL.md",
"line_start": 153,
"line_end": 157
},
{
"file": "SKILL.md",
"line_start": 157,
"line_end": 157
},
{
"file": "SKILL.md",
"line_start": 158,
"line_end": 162
},
{
"file": "SKILL.md",
"line_start": 162,
"line_end": 162
},
{
"file": "SKILL.md",
"line_start": 163,
"line_end": 163
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:3:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 3,
"line_end": 3,
"snippet": "description: This skill should be used when generating lesson summaries for educational content. It "
},
{
"id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 74,
"line_end": 97,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 97,
"line_end": 101,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 101,
"line_end": 123,
"snippet": "Adjust summary length based on lesson complexity (from frontmatter `proficiency_level`):"
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 123,
"line_end": 125,
"snippet": "Summary files are named by appending `.summary.md` to the lesson filename (without extension):"
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 125,
"line_end": 131,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 131,
"line_end": 141,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 141,
"line_end": 147,
"snippet": "7. **Write** the `.summary.md` file"
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 147,
"line_end": 153,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 153,
"line_end": 157,
"snippet": "- **Type Mismatch β Error**: `5 + \"hello\"` fails because Python can't add numbers to text"
},
{
"id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 157,
"line_end": 157,
"snippet": "- Use `type()` to verify what type Python assigned: `type(42)` returns `<class 'int'>`"
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 158,
"line_end": 162,
"snippet": "- Type hints express intent: `age: int = 25` tells both AI and humans what you expect"
},
{
"id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 162,
"line_end": 162,
"snippet": "- Storing numbers as text (`\"25\"` instead of `25`) prevents math operations"
},
{
"id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 163,
"line_end": 163,
"snippet": "- Forgetting that `0.1 + 0.2` doesn't exactly equal `0.3` (floating point precision)"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:3:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "Line 3 uses Markdown inline code around the companion file extension. It is metadata prose, not Ruby backtick execution or a shell command."
},
{
"id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Lines 74-97 are a fenced Markdown output template for generated summaries. The backticks delimit a documentation example and do not execute commands."
},
{
"id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 97 closes the Markdown output template fence. It is formatting syntax, not shell or Ruby execution."
},
{
"id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 101 uses Markdown inline code to reference a frontmatter field name. It describes lesson metadata and contains no executable command."
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "Line 123 uses Markdown inline code for the summary filename suffix. This is a file naming convention, not dynamic command execution."
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Lines 125-131 are a fenced block showing lesson and summary path examples. The block is static documentation and does not run commands."
},
{
"id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 131 closes the static path example fence. It is Markdown formatting, not Ruby or shell execution."
},
{
"id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "Line 141 instructs the agent to write the intended summary Markdown file. It uses inline code for the extension and does not invoke an external command."
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Lines 147-153 begin a fenced Markdown example of a lesson summary. The fence and sample text are documentation, not executable code."
},
{
"id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 153 contains an educational Python expression inside Markdown inline code. It illustrates a type error and is not shell command execution."
},
{
"id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 157 contains inline Python examples for a generated educational summary. The snippets are static instructional text, not executed commands."
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 158 contains a Python type-hint example in Markdown inline code. It is lesson content and does not invoke Ruby or a shell."
},
{
"id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 162 uses Markdown inline code to compare text and numeric values. It is static educational prose with no command execution behavior."
},
{
"id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "Line 163 uses Markdown inline code for a Python floating point example. It is not a shell command and cannot execute from the skill file."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 172,
"audit_model": "codex",
"audited_at": "2026-07-05T16:29:36.511Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Generate Lesson Summaries",
"value_statement": "Long lessons are hard to review when learners need fast recall. This skill creates concise Markdown summaries with concepts, patterns, mistakes, and learning connections.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"lesson summary generator",
"Markdown lesson summary",
"educational content summary",
"Socratic extraction",
"study guide automation",
"course documentation",
"learning review notes"
],
"actual_capabilities": [
"Reads a target lesson Markdown file before summarizing.",
"Extracts the proficiency level from lesson frontmatter when present.",
"Uses six Socratic questions to identify essential lesson content.",
"Produces sections for concepts, mental models, patterns, mistakes, and connections.",
"Applies word count guidelines based on lesson complexity.",
"Names companion files with the .summary.md convention."
],
"limitations": [
"Requires access to the lesson content before it can produce a useful summary.",
"Designed for educational Markdown lessons, not general business documents.",
"Does not independently verify facts beyond the source lesson.",
"May need human review for lessons with unclear prerequisites or outcomes."
],
"use_cases": [
{
"title": "Prepare Student Review Notes",
"description": "Create short companion summaries so learners can revisit core ideas without rereading a full lesson.",
"target_user": "Course author"
},
{
"title": "Refresh Existing Course Content",
"description": "Regenerate summaries after lessons change, while keeping a consistent structure across the course.",
"target_user": "Curriculum maintainer"
},
{
"title": "Support Practice Sessions",
"description": "Give learners quick references for key patterns, common mistakes, and connected topics during exercises.",
"target_user": "Instructor"
}
],
"prompt_templates": [
{
"title": "Summarize One Lesson",
"scenario": "Beginner request for a single lesson file.",
"prompt": "Use the summary-generator skill on this lesson file. Create the companion summary with the standard sections and length guidance."
},
{
"title": "Review A Draft Summary",
"scenario": "Improve an existing companion summary.",
"prompt": "Compare this lesson with its current summary. Refresh weak sections, remove full explanations, and keep only essential review content."
},
{
"title": "Batch Summarize A Module",
"scenario": "Create consistent summaries for related lessons.",
"prompt": "Apply the summary-generator process to each lesson in this module. Preserve each lesson's level, concepts, patterns, mistakes, and connections."
},
{
"title": "Audit Summary Quality",
"scenario": "Advanced quality check for course documentation.",
"prompt": "Evaluate these lesson summaries against the skill checklist. Identify missing mental models, weak practice patterns, and unclear prerequisite links."
}
],
"output_examples": [
{
"input": "A beginner lesson introduces Python data types and common type errors.",
"output": "The skill produces a short summary with the core concept, type mental models, practical patterns, common mistakes, and next learning links."
},
{
"input": "An intermediate lesson explains debugging workflows for AI-assisted coding.",
"output": "The skill extracts workflow patterns, AI collaboration keys, frequent debugging mistakes, and links to prerequisite testing knowledge."
},
{
"input": "A course author asks to refresh an outdated lesson summary.",
"output": "The skill compares the lesson against the summary, removes extra explanation, and updates the companion file structure."
}
],
"best_practices": [
"Read the full lesson before generating the summary.",
"Keep each section focused on recall, not full instruction.",
"Check the final word count against the lesson proficiency level."
],
"anti_patterns": [
"Do not include full lesson explanations in the summary.",
"Do not add practice exercises or motivational text.",
"Do not expose internal course framework labels to learners."
],
"faq": [
{
"question": "What files does this skill summarize?",
"answer": "It is designed for educational lesson files written in Markdown."
},
{
"question": "Does it create a new file?",
"answer": "Yes. The workflow names a companion summary file with the .summary.md suffix."
},
{
"question": "Does it run external commands?",
"answer": "No. The skill is a Markdown instruction file and does not define shell commands."
},
{
"question": "Can it summarize advanced lessons?",
"answer": "Yes. It provides longer word count guidance for advanced lessons with more connections."
},
{
"question": "Can it replace human editing?",
"answer": "No. Authors should review summaries for accuracy, tone, and course alignment."
},
{
"question": "Which assistants can use it?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 172
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |