tool-web
Build a lightweight single-file web application with no external dependencies
- License 许可
- MIT
- 所属仓库
- joewalnes/skills
- 最近更新
- 2026-09-09
- Stars
- ★ 3
- Forks
- 3
01 前言 Front Matter
- name
- tool-web
- description
- Build a lightweight single-file web application with no external dependencies
- argument-hint
- <description of what to build>
02 资源文件 5
- 参考文档references/css.md9.1 KB
- 参考文档references/dependencies.md2.6 KB
- 参考文档references/html.md3.0 KB
- 参考文档references/javascript.md5.3 KB
- 参考文档references/testing.md3.5 KB
03 SKILL.md 正文
Lightweight Web Tool
Build a self-contained, single-file .html web application. Everything — HTML, CSS, JavaScript — lives in one file. No build step, no frameworks, no external dependencies.
Core Rules
- Single
.htmlfile — all CSS in<style>, all JS in<script> - No frameworks — no React, Vue, Angular, Svelte, Web Components, etc.
- No CSS frameworks — no Bootstrap, Tailwind, Bulma, etc.
- No external dependencies unless explicitly approved (see External Dependencies section)
- Fast loading — with no deps, the page should render near-instantly
- Modern browsers only — target current Chrome, Firefox, Safari, Edge. No IE, no polyfills
- Clean console — zero warnings, zero errors, no stray
console.log - Works from
file:///where possible (see Compatibility section) - Responsive — must work well on mobile (320px minimum viewport)
- Add to Home Screen ready — should work as a full-screen iOS/Android home screen app
Any of these rules may be broken with a good reason and explicit user approval.
Where the rest lives
This file is the rules and the principles — read every time. The rest is read when you reach that part of the build:
| When | Read |
|---|---|
| Writing the HTML skeleton, add-to-home-screen | references/html.md |
| Styling: reset, typography, responsive, iOS Safari | references/css.md |
| Scripting: config, helpers, template/stamp, hash state, events | references/javascript.md |
| Tempted by a library or CDN | references/dependencies.md |
| Verifying it works | references/testing.md |
Images and Icons
- Prefer inline SVGs — they're scalable, styleable with CSS, and require no network requests
- Keep SVGs minimal: run through an optimizer mentally, remove unnecessary attributes
- For simple shapes, consider CSS-only solutions (borders, gradients, clip-path)
- Never use icon fonts (Font Awesome, etc.) — they're external deps and heavy
Design Principles
- Minimal, clean, no clutter — every element earns its place
- Strong visual hierarchy — primary, secondary, tertiary levels should be immediately obvious
- Generous whitespace — when in doubt, add more space
- Subtle interactions — small transitions (150–200ms) on hover/focus. No flashy animations
- Dark mode — consider
@media (prefers-color-scheme: dark)if appropriate for the tool - Accessibility basics — semantic HTML, visible focus states, sufficient color contrast
file:/// Compatibility
The page should work when opened directly as a file. This means:
Works from file:///:
- All inline CSS and JS
location.hashfor statelocalStorage/sessionStorage- Inline SVGs,
<canvas> - Most Web APIs (
crypto,Intl,Web Audio, etc.)
Does NOT work from file:///:
fetch()to relative paths — CORS restriction on file: origins- ES module
import— blocked by CORS in some browsers - Service Workers
SharedArrayBuffer/ COOP/COEP headers
If the tool requires HTTP-only features, tell the user and suggest:
python3 -m http.server 8000
04 同仓库更多 Skills
todo
Add a new bug or todo to the project's tracker
slop
Find unchosen code — surface area growing without leverage. Use pre-merge on a branch, or to check if a repo is accreting.
sitrep
Where were we? Branch, in-progress work, blocked agents, inbox, next steps. Use when resuming a session.
scorecard
暂无简介
retro
暂无简介
request
Ask another project's agents for a change instead of editing their repo. Use when a fix belongs in another repository.