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 a page brief into a reviewable route — with metadata, schema, links, and QA in the diff.
Generate SEO/GEO pages, free tools, docs, comparisons, and private ABM pages 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 contextDirect answer
Pagewell is a repo-native skill pack for coding agents that turns page briefs into normal website code. It helps create routes, content, metadata, schema, internal links, QA notes, and discovery-file updates without moving the site into a hosted builder.
Real code
Normal site code
Output lands in your Astro, Next.js, Workers, or static HTML setup — where your team already reviews routes, components, and content.
Checked
QA before merge
Metadata, schema, claims, links, design consistency, private-page behavior, and genericness are checked before you review.
What it is
The contract between your agent and your site.
Instead of asking an agent to remember routing, components, brand rules, and claim boundaries from a long prompt, Pagewell puts those rules in files. The agent reads the context, follows the playbook, and creates 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 inputs. One reviewable route.
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 diffs?
Give your coding agent the context, playbooks, and QA gates it needs to generate routes your team can review before merge.
bunx skills add ReScienceLab/pagewell --skill pagewell Installs the Pagewell agent skill via skills.sh.
Read install docs