Skip to main content

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

Project description

site2voice

Drop-in VOICE.md files. Pick a website voice, save it in your repo, and your agent writes less generic copy.

DESIGN.md tells agents how UI should look. VOICE.md tells them how copy should sound.

No install. No JSON. No generation step.

Voices

Voice 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 voice 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 for headings, CTAs, navigation labels, 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.

These are not official brand guidelines. They are derived style briefs from public pages, built to help agents write nearby copy without pasting source prose.

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 voice 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.1.tar.gz (47.0 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.1-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: site2voice-0.5.1.tar.gz
  • Upload date:
  • Size: 47.0 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.1.tar.gz
Algorithm Hash digest
SHA256 da8c6ac725c42f2872ae8a982366eb91ae3434893199669de7376972d05a05ce
MD5 76be214a8cd88637ac23a6804b80d1ca
BLAKE2b-256 7ae9528cbf2e01473345b63e58865241cfc8eac129740b11ed466d675d28a7ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: site2voice-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 15.8 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cce21f62c1a22e9d0cd3a97c2d5aa1d112052d9de3718c4e26671d91760fa2e9
MD5 47c8122ea3fa88065cc3bc2d4f8e30a1
BLAKE2b-256 d7b8a4d34d90dc5c283144b3fe1049369cde7d470a4259ce7bf246189b7bc1a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.1-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