---
name: voice-card
description: Use the vault's saved stylometry voice cards to choose a writing voice target, draft or revise prose toward that voice, and score drafts with the local profiler. Use when the user mentions voice cards, writing in a saved voice, matching Darsh's style, Anthropic/Claude-blog/Tariq/tweets/essays voice targets, or asks whether a draft sounds on-voice.
---

# Voice Card

## Overview

Use the existing vault voice-card system under `tools/stylometry/`. The canonical scorer is `tools/stylometry/profiler.py`; the saved cards are JSON files named `voice_card.*.json`.

## Workflow

1. Locate the vault root that contains `tools/stylometry/profiler.py`.
2. Select the target card:
   - `voice_card.essays.json` for Darsh essay/post voice.
   - `voice_card.tweets.json` for short-form social voice.
   - `voice_card.anthropic.json` for Anthropic Claude Code docs voice.
   - `voice_card.claude-blog.json` for Claude blog / data-analytics explanatory voice.
   - `voice_card.tariq.json` for Tariq-style writing.
3. If the user named a target, use that target immediately. Do not substitute a generic house voice.
4. Read the selected card before drafting or revising. Pay attention to sentence length, paragraph density, punctuation rates, first-person usage, function-word signature, and AI-tell baseline.
5. Draft or revise the prose using the card as a constraint, not as a costume. Preserve the user's own claims, wording, and structure unless they ask for heavier editing.
6. Score completed drafts when a file or draft text exists.

## Scoring Commands

Run from the vault root:

```bash
python3 tools/stylometry/profiler.py score path/to/draft.md --card tools/stylometry/voice_card.essays.json
```

For draft text not yet saved to a file:

```bash
cat draft.md | python3 tools/stylometry/profiler.py score - --card tools/stylometry/voice_card.claude-blog.json
```

Treat the profiler output as an editing brief. Report the highest-signal deltas in plain English, then make targeted revisions instead of chasing every metric.

## Rebuilding Cards

Build a fresh card only when the user asks, when the corpus has materially changed, or when the existing card is clearly stale:

```bash
python3 tools/stylometry/profiler.py build "posts/*.md" --out tools/stylometry/voice_card.essays.json --label essays
```

Do not overwrite an existing voice card without saying which card will change.