site2voice

Reference SITE.md and VOICE.md files for AI-generated web pages.

Pick a public web pattern, copy the matching files into your project, and give your agent structure plus writing rhythm:

• SITE.md: section order, page jobs, structure recipes, and content boundaries.
• VOICE.md: sentence rhythm, heading shape, CTA shape, claim boundaries, and benchmark gates.

Reference names identify public pages used for measurement. They do not imply official guidelines, affiliation, endorsement, or permission to reuse protected brand identity.

Context Stack

Use the files together without overlapping responsibilities:

Use the reference files for pattern, not subject matter.

Featured Profiles

The full collection now includes 33 reference-only profiles, including popular web products such as Canva, LinkedIn, Netflix, TikTok, WhatsApp, Zoom, and PayPal. See the VOICE.md collection and the SITE.md collection.

Use

Download one structure profile and one copy profile:

curl -L https://raw.githubusercontent.com/SihyeonJeon/site2voice/main/sites/stripe.md -o SITE.md
curl -L https://raw.githubusercontent.com/SihyeonJeon/site2voice/main/voices/stripe.md -o VOICE.md

Tell your agent:

Use @SITE.md for page structure and @VOICE.md for copy rhythm. Bring our own product nouns, facts, and claims.

Each file is plain Markdown. Public profiles remove source nouns, raw CTAs, navigation labels, paragraph samples, logos, screenshots, and brand assets. Use SITE.md when building a web page; use VOICE.md when writing headings, CTAs, UI copy, and launch copy.

See Brand Usage for the boundary rules.

Not DESIGN.md

DESIGN.md describes visual identity: colors, typography, spacing, components, layout, and responsive behavior. SITE.md describes page structure: section order, section jobs, page archetype, and content boundaries. VOICE.md describes writing behavior: rhythm, CTA shape, claim safety, and copy-safety gates.

Read the role map in DESIGN.md vs SITE.md / VOICE.md.

Before / After

Same LedgerFlow prompt, scored against Stripe:

See the full comparison.

For a visible web result, see the SITE.md + VOICE.md web comparison. It shows the same HTML landing-page prompt with and without the context files, including screenshots and a reference-fit score.

Optional CLI

Generate a new context pack from any public URL:

pipx install site2voice
site2voice init https://example.com

Generate only a page-structure file:

site2voice site https://example.com --out SITE.md

Validate generated copy:

site2voice bench https://example.com draft.md --strict

Need site.json, voice.json, or an agent prompt too? Use the full context packs.

Status

Develop

python3 -m pip install -e .
make test
make bench-ci

License

MIT