HTML Research, Reports & Learning

HTML reports get read; markdown reports of the same length don't. Use HTML whenever the goal is for a human (often someone other than the user) to actually absorb information — concept explainers, status reports, incident reports, knowledge transfer.

When to use this skill

• "Summarize how X works"
• "Explain the Y system to me / to my team / to leadership"
• "Write up the incident from yesterday"
• "Weekly status update for my manager"
• "I want to learn about X — synthesize from the codebase + git history + web"
• "Prepare a technical brief on Z"
• Any time the goal is comprehension or sharing, not implementation

Output requirements

Designed for one-time reading — optimize for the reader who opens it once, gets what they need, closes it. Navigable by scrolling and, for longer reports, a sticky sidebar TOC or tab strip.