Skip to main content

Ready-to-use VOICE.md copy profiles and optional benchmarks for AI-generated copy.

Project description

site2voice

Drop-in VOICE.md copy profiles. Pick a public writing pattern, save one file, and your agent writes less generic copy.

site2voice is not a visual design-system library and not a brand-cloning tool. It turns public copy into a compact, reference-only writing contract: sentence rhythm, heading shape, CTA verb shape, claim boundaries, and benchmark gates.

No install. No JSON. No generation step.

Not official. Not affiliated. Not permission to impersonate a brand.

Voices

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

Use

Download one copy profile as VOICE.md:

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

Tell Claude Code, Codex, Cursor, or Copilot:

Use @VOICE.md as a copy contract for headings, CTA shape, paragraph rhythm, and UI microcopy.

Each file is a plain Markdown writing brief with sentence rhythm, heading shape, CTA verbs, content boundaries, claim boundaries, and a benchmark target. The public profiles remove source nouns, raw CTAs, navigation labels, paragraph samples, logos, screenshots, and brand assets.

Reference names identify the public page used for measurement. They do not imply sponsorship, endorsement, affiliation, or permission to reuse protected brand identity. See Brand Usage.

Not DESIGN.md

DESIGN.md describes visual identity: colors, typography, spacing, components, layout, and responsive behavior. VOICE.md describes writing behavior: rhythm, CTA shape, information order, claim safety, and copy-safety gates.

Read the full comparison in DESIGN.md vs VOICE.md and the dated competitive review.

Before / After

Same LedgerFlow prompt, scored against Stripe:

Candidate Result Overall Variety CTA Copy safety
Without VOICE.md FAIL 60.4 40.5 50.0 100.0
With VOICE.md PASS 91.0 45.8 100.0 96.2

See the full comparison.

Optional CLI

Generate a new copy profile from any public URL:

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

Validate generated copy:

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

Need 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

site2voice-0.5.2.tar.gz (51.7 kB view details)

Uploaded Source

Built Distribution

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

site2voice-0.5.2-py3-none-any.whl (16.4 kB view details)

Uploaded Python 3

File details

Details for the file site2voice-0.5.2.tar.gz.

File metadata

  • Download URL: site2voice-0.5.2.tar.gz
  • Upload date:
  • Size: 51.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for site2voice-0.5.2.tar.gz
Algorithm Hash digest
SHA256 2001ee58c266b7bf957bf648f542f44d7c0006bbc7c3ee3d054718d1f464e7f5
MD5 8d73ad2db8ee499a95efee8be2dbd66f
BLAKE2b-256 53cf359a6200ccd99c17ac49f5cab01def25ec5edda61600cde3e11facb0280b

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.2.tar.gz:

Publisher: publish.yml on SihyeonJeon/site2voice

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

File details

Details for the file site2voice-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: site2voice-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 16.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for site2voice-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 171eafed42e6b06a61784678b469ead174fbf46ee642a02741c4d98ebeb8ef78
MD5 3ddc816a067c94a8379b239cc56d54e2
BLAKE2b-256 e5d16d9da09af16543dc97777720d69904c98994a951f1287d1a165fa62de64b

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.2-py3-none-any.whl:

Publisher: publish.yml on SihyeonJeon/site2voice

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