Skip to main content

Ready-to-use SITE.md and VOICE.md context packs for AI-generated web structure and copy.

Project description

site-voice-packs

Drop-in SITE.md and VOICE.md context packs 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:

Context Owns Must not supply
Project brief product category, audience, facts, domain nouns, examples, offer, claims reference-site nouns
DESIGN.md colors, typography, spacing, layout grid, components, motion, imagery style copy rhythm or claims
SITE.md page structure, section order, section jobs, conversion path colors, fonts, product category
VOICE.md sentence rhythm, heading behavior, CTA shape, claim boundaries product nouns, visual design

Use the reference files for pattern, not subject matter.

Featured Profiles

Profile Tone Best for
Apple premium, minimal product launches
Anthropic measured, institutional AI safety and product pages
EYESMAG concise, culture-led Korean fashion and lifestyle copy
Figma collaborative, creative design-tool pages
GitHub developer-first platform and ecosystem copy
Highsnobiety editorial, commerce-aware culture and fashion launches
Hypebeast trend-led streetwear and culture blurbs
Linear precise, product-team SaaS positioning
Monocle polished, global city, design, and affairs copy
Notion simple, workspace productivity pages
OpenAI research-to-product AI product pages
Shopify merchant-growth commerce pages
Stripe calm, technical fintech and SaaS copy
Vercel performance-led developer platform pages
Wallpaper design-editorial architecture and interiors copy

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/site-voice-packs/main/sites/stripe.md -o SITE.md
curl -L https://raw.githubusercontent.com/SihyeonJeon/site-voice-packs/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:

Candidate Result Overall Variety CTA Copy safety
Without VOICE.md FAIL 63.8 40.5 25.0 100.0
With VOICE.md PASS 91.1 45.8 100.0 96.2

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 webfit score.

webfit makes the visual comparison reproducible:

site2voice webfit \
  --voice packs/stripe/voice.json \
  --site packs/stripe/site.json \
  --min-delta 20 \
  --min-copy-safety 95 \
  --max-mimic-risk 5 \
  examples/comparisons/stripe-ledgerflow-web/without-context.html \
  examples/comparisons/stripe-ledgerflow-web/with-site-voice.html

Optional CLI

Generate a new context pack from any public URL:

pipx install site-voice-packs
site2voice init https://example.com

The PyPI package uses the repo name, site-voice-packs. The CLI keeps site2voice and also exposes site-voice-packs.

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

Score visible HTML outputs:

site2voice webfit --voice voice.json --site site.json before.html after.html

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

Status

PyPI CI License: MIT

Develop

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

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

site_voice_packs-0.6.1.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

site_voice_packs-0.6.1-py3-none-any.whl (26.5 kB view details)

Uploaded Python 3

File details

Details for the file site_voice_packs-0.6.1.tar.gz.

File metadata

  • Download URL: site_voice_packs-0.6.1.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for site_voice_packs-0.6.1.tar.gz
Algorithm Hash digest
SHA256 c6e5ed383d8a0f9e8782b46dc6296673176fbd883a250c6425974ee0ee20191d
MD5 6775f0c463878abfce89e2ae9bca3240
BLAKE2b-256 04fa3a88b7db16a4fcd8cee0d76c69f854ed60eabed85ce9cd611f674fb37ae1

See more details on using hashes here.

Provenance

The following attestation bundles were made for site_voice_packs-0.6.1.tar.gz:

Publisher: publish.yml on SihyeonJeon/site-voice-packs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file site_voice_packs-0.6.1-py3-none-any.whl.

File metadata

File hashes

Hashes for site_voice_packs-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cb10e8349aa714713339492b610a9b5f147f2c1815c5822348c5561a5486d7fa
MD5 cda969e9657eb1983b74e19505bc6c58
BLAKE2b-256 f4ec58949a0b0dc3bb7e839770fe3fed55236d4484c10d4f61a0edaba134f0f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for site_voice_packs-0.6.1-py3-none-any.whl:

Publisher: publish.yml on SihyeonJeon/site-voice-packs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page