agentic-site-building
Skill2 starsChanged 4 months agoMITView on GitHub
Design, implement, or harden an AI website-building agent that turns natural-language requests into scoped code changes with planning, structured edits, deterministic verification, bounded repair, safe previewing, version history, and token-aware model routing.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- conversion-accessibility-polishSkill
- landing-page-craftSkill
- production-web-architectureSkill
- product-motion-designSkill
- responsive-ui-qaSkill
- technical-seo-discoverySkill
- web-design-systemSkill
- web-visual-directionSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Prefer a structured patch for an existing artifact.
- Distinctive: line 16
If validation fails, give the verifier evidence to one bounded repair attempt.
- Distinctive: line 30
Keep generated code facts grounded in user data.
- Distinctive: line 45
Read references/orchestration-contract.md when defining schemas, retry policy, or production metrics.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Agentic Site Building
Build editing systems that can prove a requested change happened without rewriting unrelated work or claiming success on a no-op.
Workflow
- Map the editable artifact, source of truth, preview boundary, model providers, persistence, and rollback path.
- Compile each request into an explicit contract: mode, target surface, allowed change radius, acceptance criteria, and risk.
- Prefer a structured patch for an existing artifact. Require exact, unique anchors and a bounded change budget.
- Apply patches locally, then validate syntax, structure, requested-surface change, and collateral-change limits.
- If validation fails, give the verifier evidence to one bounded repair attempt. Escalate to a full rewrite only when scope requires it or patching is unsafe.
- For redesigns, reject the current composition deliberately while preserving factual content and product constraints.
- Render generated code in an isolated preview. Keep authentication, storage, parent DOM, and privileged network access outside the generated runtime.
- Save only accepted outputs. Keep restorable revisions with prompt, mode, verifier result, and prompt/model version.
- Expose honest progress and failure states. Never label an unchanged or unverified preview as updated.
- Measure patch success, no-op rate, repair rate, latency, token cost, rollback rate, and user acceptance.
Decision Rules
- Deterministic code owns safety and common runtime contracts; the model owns interpretation and creative composition.
- A small edit should not receive the full site unless the patch path fails safely.
- Verification must inspect the requested surface, not only whole-file similarity.
- Retries must use new evidence and stop after a fixed budget.
- Provider fallback handles availability; it must not silently weaken required structured-output or context capabilities.
- Keep generated code facts grounded in user data. Do not invent projects, metrics, employers, or media.
Delivery Contract
Provide or implement:
- Execution contract - modes, scope, acceptance criteria, and escalation rules.
- Orchestration path - plan, patch or build, validate, repair, persist, preview, rollback.
- Verifier design - deterministic checks and evidence returned to repair attempts.
- Safety boundary - generated-code sandbox and authorization limits.
- Efficiency budget - context selection, model routing, retries, and stopping conditions.
- Operational proof - tests for no-op, collateral edit, failed patch, retry, rollback, and preview isolation.
Reference
Read references/orchestration-contract.md when defining schemas, retry policy, or production metrics.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

