explanation-artifact-generator

What problem does it solve?

This skill guides authors to capture and formalize their understanding of a project artifact by guiding a four-question comprehension process and producing a living explanation artifact alongside the code.

Core Features & Use Cases

• Step-by-step user interview flow: prompts the user with four focused questions to gather context, rationale, risks, and learnings.
• Artifact assembly: automatically formats answers into a structured Markdown artifact that documents comprehension and reasoning.
• Lightweight, human-centric: emphasizes explicit reflection rather than automated code generation, ensuring a traceable proof of understanding.
• Use cases include documenting repos, features, tools, or deployments to accompany codebases and onboarding.

Quick Start

Ask the user to select a subject (repo, feature, tool, or deployment) and answer the four questions to generate EXPLANATION.md alongside the code.