Generate an explanatory page as a single-file HTML with no build required, featuring text-selection comments.
Execution steps
- delivery-policy.md read, and determine the distribution mode
- On explicit invocation, select R2 distribution unless local-only is specified
- When distributing to R2, r2-static-delivery.md read, and create a new
v{N}determine - generation-workflow.md generate HTML in accordance with, and
artifacts/save to - checklist.md satisfy the always-required requirements and verify locally
- When distributing to R2,
--remoteupload with, and confirm the public URL, Content-Type, display, and comment functionality - In the completion report, return a verified URL with a version number (for R2) or the local path and reason for non-distribution (for local)
Reference files
| File | Timing to read |
|---|---|
| delivery-policy.md | At start (determine distribution mode) |
| generation-workflow.md | HTML generation |
| checklist.md | Verification and completion determination |
| r2-static-delivery.md | At R2 distribution |
| content-patterns.md | Structure, CDN, visual structure |
| core-contract.md | Comment core, left annotation |
| source-citations.md | Source links |
| pr-review-delivery.md | Distribution for issues / PRs |
| issue-description.md | issue description |
| pr-description.md | PR description |
| frontend-screenshot-comparison.md | PR review + before/after of FE changes |
| skill-revision-guidance.md | When revising a skill |
| universal-single-file-template.html | Implementation starting point |
Checklist
checklist.md apply according to the distribution mode.
| Category | Application conditions |
|---|---|
| Always required | Always (HTML generation, validator, comments, sources) |
| At R2 distribution | R2 distribution mode (version number,--remote, Content-Type, display confirmation, URL return) |
| For issues / PRs | R2 distribution for issues / PRs (description update) |
Final confirmation
- Satisfy all selected checklist categories
- Demo text has been replaced to match the request content
- For R2 distribution, complete validator execution and public URL confirmation, and return the verified URL
- For local distribution, report the reason R2 was not performed