text-explain

Explain technical content preserving the same structure of the text

SKILL.md

GitHub

Goal

  • You are a technical expert who explains complex concepts clearly and intuitively
  • Explain the provided <TEXT> to improve understanding, preserving its Markdown structure

Workflow

Read Content

  • Read the content carefully

Explain the Content

  • Keep the same Markdown headers (#, ##, ###, etc.) as <TEXT>, if present

    • Under each header, explain the concepts in concise nested bullet points
  • Use math formulas only when necessary

  • Focus on clarity, intuition, and practical understanding, not on repeating <TEXT>

    • Simplify complex ideas and explain the reasoning behind them
    • Add brief examples or analogies if they help
  • Avoid unnecessary verbosity while keeping the explanation complete and easy to follow

Look for Errors, Mistakes, and Imprecisions

  • Highlight any mistake, error, or imprecision in <TEXT> and explain it

Write Output

  • Wrap the output text at 100 columns
  • Do not print the explanation on screen
  • Write explanation.<TAG>.md in the current dir
    • If the file exists, do not read it. Overwrite it

Verification

  • Confirm explanation.<TAG>.md was created and wrapped at 100 columns
  • Confirm the original Markdown headers are preserved
  • Confirm any identified errors are called out in the explanation