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
Develop
python3 -m pip install -e .
make test
make bench-ci
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
da8c6ac725c42f2872ae8a982366eb91ae3434893199669de7376972d05a05ce
|
|
| MD5 |
76be214a8cd88637ac23a6804b80d1ca
|
|
| BLAKE2b-256 |
7ae9528cbf2e01473345b63e58865241cfc8eac129740b11ed466d675d28a7ce
|
Provenance
The following attestation bundles were made for site2voice-0.5.1.tar.gz:
Publisher:
publish.yml on SihyeonJeon/site2voice
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
site2voice-0.5.1.tar.gz -
Subject digest:
da8c6ac725c42f2872ae8a982366eb91ae3434893199669de7376972d05a05ce - Sigstore transparency entry: 1582982585
- Sigstore integration time:
-
Permalink:
SihyeonJeon/site2voice@012a7866018ad8a4a60fb6b1e7fa78b98bb5e57a -
Branch / Tag:
refs/tags/v0.5.1 - Owner: https://github.com/SihyeonJeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@012a7866018ad8a4a60fb6b1e7fa78b98bb5e57a -
Trigger Event:
release
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cce21f62c1a22e9d0cd3a97c2d5aa1d112052d9de3718c4e26671d91760fa2e9
|
|
| MD5 |
47c8122ea3fa88065cc3bc2d4f8e30a1
|
|
| BLAKE2b-256 |
d7b8a4d34d90dc5c283144b3fe1049369cde7d470a4259ce7bf246189b7bc1a7
|
Provenance
The following attestation bundles were made for site2voice-0.5.1-py3-none-any.whl:
Publisher:
publish.yml on SihyeonJeon/site2voice
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
site2voice-0.5.1-py3-none-any.whl -
Subject digest:
cce21f62c1a22e9d0cd3a97c2d5aa1d112052d9de3718c4e26671d91760fa2e9 - Sigstore transparency entry: 1582982695
- Sigstore integration time:
-
Permalink:
SihyeonJeon/site2voice@012a7866018ad8a4a60fb6b1e7fa78b98bb5e57a -
Branch / Tag:
refs/tags/v0.5.1 - Owner: https://github.com/SihyeonJeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@012a7866018ad8a4a60fb6b1e7fa78b98bb5e57a -
Trigger Event:
release
-
Statement type: