hyv-score

SkillDev tools

Score a draft against an explicit held-out local writing band.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the hyv-score skill

What this skill tells your AI

The instructions your AI receives, as published by shashank-sn/holdyourvoice in skills/hyv-score/SKILL.md and read by ahel’s review.

Use this with three or more samples that were not used to build the profile. It reports whether a candidate sits inside the writer's observed range. It is local-only and is not an authorship, factuality, or publication-quality score. Profile v3 adds channel-aware scoring; Profile v2 remains general-channel compatible.

Usage

hyv score draft.md profile.json heldout-a.md heldout-b.md heldout-c.md [--channel=email|chat|long-form|social|docs|general]

Behavior

  • Use only writing the owner has authorized and retain no new samples or telemetry.
  • Keep profile-building and held-out samples separate. Do not relabel a different channel to force a score.
  • HYV abstains when there are too few usable held-out samples, language confidence is insufficient for its English-oriented metrics, or the channel conflicts with the profile. Report that abstention rather than treating it as a failure or a score.
  • The result includes component similarity and the writer's own pairwise range. A high score is not proof that the candidate was written by the person.
  • This command is read-only. It does not call a provider, change a draft, or write a profile.

Handoff

Use hyv-rewrite-prompt for a bounded external editing brief, then hyv-verify for candidate verification. Re-run this score only with the same explicit held-out set when comparing drafts.

Signals

GitHub stars
32
Last commit
Sep 2026
Advanced
Item type
skill
Key
hyv-score
Source
github.com/shashank-sn/holdyourvoice