html-research-notes
Create structured research, engineering, and thesis workflow notes as standalone HTML instead of Markdown, with metadata blocks, internal links, readable academic styling, print-friendly layout, templ
SKILL.mdskills/html-research-notes/SKILL.md
GitHubHTML Research Notes
Use this skill to make local, linkable, print-friendly HTML notes that work without a build step.
Workflow
- Choose the note type:
- hub/index;
- decision log;
- claim manifest;
- experiment manifest;
- figure manifest;
- review report;
- how-to/workflow guide.
- Start from a template in
assets/when possible. - Include a metadata block near the top:
- owner;
- status;
- last updated;
- source links or commit;
- intended audience.
- Use semantic HTML:
header,main,section,table,nav;- stable IDs for headings;
- relative links between pages.
- Apply a utilitarian reading style:
- dense but readable;
- strong tables;
- no decorative landing-page treatment;
- print-friendly CSS.
- Validate links and viewport fit. Use Playwright when a visual check matters.
Guardrails
- Do not create Markdown workflow records unless an external tool requires it.
- Do not embed secrets, raw private logs, or bulky generated outputs.
- Do not rely on a build system for basic navigation.
- Keep pages readable when opened directly from disk.
Useful Resources
- Read
references/html-note-rules.htmlfor styling and structure rules. - Use
assets/note-template.htmlas a starter page.