Agent skill

Markdown to HTML Report

by MegaSuperKitty in MegaSuperKitty/WeClaw

Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

MITAuto-check passedDocuments & Office

Install Markdown to HTML Report

skills CLI
$ npx skills add MegaSuperKitty/WeClaw --skill report-html-windows -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MegaSuperKitty/WeClaw report-html-windows --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MegaSuperKitty/WeClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/report-html-windows .claude/skills/report-html-windows && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
report-html-windows
GitHub stars
370
Token cost
~456 tokens
SKILL.md length
171 words
Files
6 (incl. scripts, references, assets)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

  • Drafting a shareable report with sections, headings and citations
  • SKILL.md covers Overview, Workflow, Citation Rules and Quick Start, plus 2 more sections
  • Runs Python scripts from its folder; calls python; reaches ihchina.cn
  • Converting a Markdown outline into a styled HTML report

What it does

The agent first asks for the topic, audience and tone, the sections and bullet points to cover, any branding assets and page size, and the sources to cite. It drafts the report body in Markdown using headings and lists, placing a numbered citation after each factual claim and collecting the full list of sources under a references heading at the end, so citations are never left out for claims that need them.

The Markdown is then converted to HTML with scripts/report_from_md.py, which applies a bundled Jinja2 template, and the result can be adjusted and re-rendered as needed. Reference files describe the suggested report structure and the required and optional dependencies for the conversion script.

When your agent uses it

  • Drafting a shareable report with sections, headings and citations
  • Converting a Markdown outline into a styled HTML report
  • Producing a report with proper source attribution for factual claims

Example prompts

  • “Draft a report on this quarter's user growth with citations, then render it to HTML.”
  • “Turn my outline in reports/draft.md into a styled HTML report titled Quarterly Report.”
  • “Write a report on CRISPR advances in 2026 and keep every claim cited.”

Requirements

  • Python with the markdown and Jinja2 packages

What it can do on your machine

Read from SKILL.md and the folder at commit de8bbbd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ihchina.cn

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Markdown to HTML Report loads about 456 tokens when it runs, and up to ~583 if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 171 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~456
With references · SKILL.md plus every file in references/, read only if the agent opens them
~583

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from MegaSuperKitty/WeClaw at commit de8bbbd, republished under its MIT licence (© MegaSuperKitty). 171 words, ~456 tokens.

Download SKILL.mdSave it as .claude/skills/report-html-windows/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
report-html-windows
description
Create report-style HTML on Windows using Python. Use when the user asks to draft a report, generate HTML from an outline/markdown, or produce a shareable report with sections, headings, and citations. Default output is HTML.

Report Html Windows

Overview

Generate report HTML from an outline or Markdown. Default output is HTML using markdown + Jinja2 template.

Workflow

  1. Collect inputs Ask for:
  • Topic, audience, and tone
  • Sections and bullet points
  • Branding assets (logo, colors) and page size
  • Sources to cite (URLs or bibliographic entries)
  1. Draft the content Write the report in Markdown using headings and lists. Always include citations in the body and a references section. Use a simple, consistent format so the model won’t “forget” how to cite:
  • Inline numeric citations after claims: ……事实陈述[1]
  • References section at the end:
    • ## 参考资料
    • [1] 标题 - URL
    • [2] 标题 - URL

Example:

markdown
年画在清代达到鼎盛。[1]

## 参考资料
[1] 滩头年画的故事 - https://www.ihchina.cn/news_1_details/10963.html
  1. Render to HTML Use scripts/report_from_md.py to convert Markdown to styled HTML.

  2. Review and iterate Adjust sections, styling, and assets as needed.

Citation Rules

Use numeric inline citations and a references section (see example above). Do not omit citations for factual claims.

Quick Start

bash
python scripts/report_from_md.py --md reports/draft.md --out build/report.html --title "Quarterly Report"

Scripts

  • scripts/report_from_md.py:
    • Markdown -> HTML
    • Uses a Jinja2 HTML template in assets/report_template.html

References

  • references/report_format.md: Suggested structure and content outline.
  • references/dependencies.md: Required and optional dependencies.

© MegaSuperKitty, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references, assets) in skills/report-html-windows of MegaSuperKitty/WeClaw.

  • SKILL.md
  • agents/openai.yaml
  • assets/report_template.html
  • references/dependencies.md
  • references/report_format.md
  • scripts/report_from_md.py

Open the folder on GitHubat commit de8bbbd

Compare with similar skills

Markdown to HTML Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Markdown to HTML Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markdown to HTML Report this skillMegaSuperKitty/WeClaw370—~456Automated safety check: PassMIT
Markdown to Word Convertercat-xierluo/SuitAgent205—~559Automated safety check: PassMIT
Bookforge Korean Ebook PDF Makergongnyang/bookforge3161 repos~1.7kAutomated safety check: PassMIT
Literature Surveyai4s-research/ai4s-skills2372 repos~2kAutomated safety check: PassMIT
Academic LaTeX Formatterlingzhi227/agent-research-skills390—~603Automated safety check: PassNone
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown to Word Converter

    cat-xierluo/SuitAgent

    Converts Markdown files into Word documents formatted to Chinese typesetting conventions, with presets for academic, legal, report and book layouts.

    205 GitHub stars~559 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.

    316 GitHub starsUsed in 1 repo~1.7k tokens
    Documents & OfficeAuto-check passed
  • Literature Survey

    ai4s-research/ai4s-skills

    A skill your agent uses when the user wants a comprehensive literature survey on a specific research topic.

    237 GitHub starsUsed in 2 repos~2k tokens
    Documents & OfficeAuto-check passed
  • Academic LaTeX Formatter

    lingzhi227/agent-research-skills

    Sets up conference-specific LaTeX paper templates, checks a draft for formatting and submission issues, and auto-fixes common problems for venues like ICML, ICLR, NeurIPS, AAAI and ACL.

    390 GitHub stars~603 tokensUpdated 7 mo ago
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Doc Cleaner

    notoriouslab/doc-cleaner

    Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.

    309 GitHub stars~712 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from MegaSuperKitty/WeClaw

  • PPTX Builder for Windows

    MegaSuperKitty/WeClaw

    Builds PowerPoint decks on Windows from a structured slide spec using python-pptx, with an optional HTML-to-PDF-to-image path for complex layouts.

    370 GitHub stars~650 tokensUpdated 5 mo ago
    Auto-check passed
  • PDF Toolkit for Windows

    MegaSuperKitty/WeClaw

    Perform PDF operations on Windows using Python. Use for merging, splitting, rotating, extracting text, and stamping PDFs. Supports batch-safe scripts with…

    370 GitHub stars~192 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Markdown to HTML Report

What does Markdown to HTML Report do?

Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows. The agent first asks for the topic, audience and tone, the sections and bullet points to cover, any branding assets and page size, and the sources to cite. It drafts the report body in Markdown using headings and lists, placing a numbered citation after each factual claim and collecting the full list of sources under a references heading at the end, so citations are never left out for claims that need them.

When should I use Markdown to HTML Report?

Markdown to HTML Report fits situations like: drafting a shareable report with sections, headings and citations; converting a Markdown outline into a styled HTML report; producing a report with proper source attribution for factual claims.

How do I install Markdown to HTML Report in Claude Code?

Run `npx skills add MegaSuperKitty/WeClaw --skill report-html-windows -a claude-code`. Or copy the skill folder (skills/report-html-windows in MegaSuperKitty/WeClaw) into .claude/skills/report-html-windows in your project. Claude Code loads it when a task matches its description.

How do I install Markdown to HTML Report in Codex?

Run `npx skills add MegaSuperKitty/WeClaw --skill report-html-windows -a codex`. Or copy the skill folder (skills/report-html-windows in MegaSuperKitty/WeClaw) into .agents/skills/report-html-windows in your project. Codex loads it when a task matches its description.

Can I use Markdown to HTML Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MegaSuperKitty/WeClaw --skill report-html-windows -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/report-html-windows, .gemini/skills/report-html-windows, .github/skills/report-html-windows and .opencode/skills/report-html-windows in your project.

What does Markdown to HTML Report need to run?

Going by SKILL.md and its folder, Markdown to HTML Report needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python with the markdown and Jinja2 packages.

Does Markdown to HTML Report access the network?

SKILL.md names 1 domain. In commands or code: ihchina.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Markdown to HTML Report safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Markdown to HTML Report use?

Markdown to HTML Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Markdown to HTML Report use?

About 456 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 127 tokens, read only when the agent opens those files.

What are the alternatives to Markdown to HTML Report?

Skills that share tags, products or a category with Markdown to HTML Report: Markdown to Word Converter (cat-xierluo/SuitAgent, 205 stars), Bookforge Korean Ebook PDF Maker (gongnyang/bookforge, 316 stars), Literature Survey (ai4s-research/ai4s-skills, 237 stars) and Academic LaTeX Formatter (lingzhi227/agent-research-skills, 390 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown to HTML Report?

MegaSuperKitty (a GitHub user) maintains it in MegaSuperKitty/WeClaw, which has 370 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on May 8, 2026.

Source: MegaSuperKitty/WeClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.