Your rules
DESIGN.md + PAGEWELL.md
DESIGN.md holds your visual rules. PAGEWELL.md holds your product facts, site conventions, and page patterns. Agents read both before touching code.
Product
Turn page requests into production-ready code — without losing control of your repo.
Ship search-ready pages, free tools, docs, comparisons, and private ABM pages — all as normal code in your existing repo. No hosted builder. No platform migration.
bunx skills add ReScienceLab/pagewell --skill pagewell Installs the Pagewell agent skill via skills.sh.
Read setup contextReal code
Normal site code
Output goes into your Astro, Next.js, Workers, or static HTML setup — not a hosted platform.
Checked
QA before merge
Every run checks metadata, schema, claims, links, design consistency, and genericness before you review.
What it is
The context layer between your agent and your site.
Instead of prompting your agent from scratch every time — and hoping it remembers your routing, components, and brand rules — Pagewell gives it a playbook. The agent reads your context, follows your patterns, and generates a page you can review like any other code change.
- The router chooses the right module and playbook from a natural-language request.
- The generator creates a framework-neutral page spec before touching code.
- The implementation follows the current repo's route, layout, metadata, and component conventions.
Mechanism
Three files. One consistent page.
01
PAGEWELL.md
Product facts, supported claims, prohibited claims, site implementation, route taxonomy, component patterns, generation rules, and anti-generic QA rules.
02
DESIGN.md
Colors, typography, spacing, component guidance, and visual do's/don'ts using the Google DESIGN.md format.
03
Playbook
Product, use-case, FAQ, glossary, comparison, docs, LP, private, and free-tool coverage rules that adapt to the site instead of forcing a fixed template.
Example spec
What the agent sees before it writes a single line of code.
route: /use-cases/generate-seo-pages-as-code
pageType: use-case
primaryKeyword: generate SEO pages as code
context: PAGEWELL.md + DESIGN.md
coverage:
- direct answer
- repo workflow
- adapter implementation
- QA and discovery gates
antiGeneric:
- cite product mechanics
- avoid generic Problem/Solution headingsFAQ
Common questions, answered directly.
What is Pagewell?
Pagewell is a repo-native skill pack for coding agents. It helps agents turn page briefs into normal website code with metadata, schema, claim checks, QA, and discovery updates.
Does Pagewell host my pages?
No. Pagewell works inside your existing repo and follows your site's framework conventions. Your existing build and deployment flow still owns hosting and publishing.
What files should Pagewell read before generation?
Pagewell should read DESIGN.md for visual rules, PAGEWELL.md for product/site/pattern truth, and a page brief for the route, audience, intent, CTA, and constraints.
Install Pagewell
Ready to turn briefs into code?
Give your coding agent the context, playbooks, and QA gates it needs to generate production pages in your repo.
bunx skills add ReScienceLab/pagewell --skill pagewell Installs the Pagewell agent skill via skills.sh.
Read install docs