skills.rest
amitkarpe
amitkarpeCOMMUNITY
Explore all skills by this author →
Website𝕏@amitkarpeGitHub

web-html-page

Generate compact self-contained dark-themed HTML operational reports from JSON specs.

Updated Apr 14, 2026
Search Tags:#static site#dark theme#html report#report generator#offline html#json spec#operational summary
One-click install
npx skills add https://github.com/amitkarpe/agent-skills --skill web-html-page-amitkarpe
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-html-page
Source: https://github.com/amitkarpe/agent-skills/tree/main/skills/web-html-page
Command: npx skills add https://github.com/amitkarpe/agent-skills --skill web-html-page-amitkarpe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? After a coding or ops run, terminal output is hard to scan and share. This Skill turns task results, diffs, and evidence into a small, offline-safe HTML report published to a local LAN URL, without building a full dashboard. ## Core Features & Use Cases - Deterministic JSON-spec rendering: Write a small report.spec.json using an approved component catalog (Hero, TLDR, StatusCards, EvidenceTable, RiskBox, NextAction, Timeline, Checklist), then render it to styled HTML with scripts/render_html_from_spec.py. - Built-in safety validation: validate_spec.py and validate_html.py block external URLs, credential-like values, account IDs, raw HTML, and white/day backgrounds before publishing. - LAN publishing with lifecycle: publish_html.py copies output to /opt/crypto-web/fast/<slug>/, writes evidence copies, validates the URL with curl, and archive_old_reports.py enforces a 7-day retention policy. - Use Case: After a worker run, ask for a quick web report; the Skill produces a Midnight Compact dark page with TL;DR, status cards, evidence table, risks, and next action at http://home/fast/<slug>/. ## Quick Start Ask the agent to publish a quick HTML report summarizing what changed in the current task, and it will generate the spec, validate, render, and return the local URL.

Frequently Asked Questions about web-html-page

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a quick HTML report after a coding task?▼

Create a report.spec.json using components from the catalog, run validate_spec.py, then render_html_from_spec.py to produce output.html. Publish with publish_html.py to get a local URL like http://home/fast/<slug>/.

What components are available in the JSON report spec?▼

The catalog allows Page, Hero, TLDR, StatusCards, EvidenceTable, RiskBox, NextAction, Timeline, Checklist, and Section. Unknown component types or props are rejected by validate_spec.py before rendering.

Can the HTML report use external CSS, fonts, or CDN assets?▼

No. Reports must be fully self-contained and offline-safe. Both validate_html.py and publish_html.py block external URLs, remote fonts, and CDN references, and the design forbids white/day backgrounds outside print CSS.

When should I use this instead of a full dashboard or diagram skill?▼

Use it for compact operational summaries after a run. For rich architecture diagrams or visual teaching use visual-explainer, and for durable research or study dashboards use deep-work, as directed by the skill's own boundaries.

Why did spec validation fail on my report?▼

Common causes are unknown component types, missing required props, children referencing nonexistent elements, external URLs, credential-like strings, or 12-digit account-like numbers. Replace unknown IDs with 'unknown / needs refresh' or pass --allow-account-ids.

Related Skills

Explore More Software Engineering Skills→
MengToMengTo
5.7k

audit-verify-explain-grade-5

Audits changes, verifies claims with evidence, and explains results in plain language.

Community
Basic
jasonqweenjasonqween

memory-hygiene

Prune old AI agent ideas and archive them after a 7-day TTL.

Community
Intermediate
DSado88DSado88
1

squall-deep-research

Execute single-agent deep research workflows with web-sourced evidence and citations.

Community
Advanced
videojsvideojs
931

write-html-component-design

Write HTML component design records documenting element boundaries and rationale.

Official
Basic