voice-learn
Improves a voice profile by learning from manual edits. Use after editing generated text to refine registers and close voice drift over time.
Install / Use
npx skills add athola/claude-night-market --skill voice-learnInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of voice-learn
voice-learn scores 89/100 on our quality scale, 526th of 1,148 Content & Media skills we index (top 46%).
Its SKILL.md is 6.3 KB long, well organised into 20 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
It has 338 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so voice-learn is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
voice-learn compared with similar skills
All 4 of these similar skills score higher than voice-learn; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| voice-learn (this skill)by athola | 89 | 338 | 59d ago | SKILL.md |
| LocalAIby mudler | 100 | 50.5k | today | MCP Server |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
Frequently asked questions
- How do I install voice-learn?
- Run
npx skills add athola/claude-night-market --skill voice-learn. The install tabs above show the steps for each supported agent. - Which AI agents does voice-learn work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is voice-learn safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is voice-learn still maintained?
- The repository was last updated about 2 months ago, so voice-learn is actively maintained.
Skill content
View source on GitHubname: voice-learn description: Improves a voice profile by learning from manual edits. Use after editing generated text to refine registers and close voice drift over time. globs: "**/*.{md,txt}" alwaysApply: false category: writing-quality tags:
- voice
- learning
- improvement
- feedback
- iteration tools: [] complexity: high estimated_tokens: 2000 progressive_loading: true modules:
- modules/snapshot-management.md
- modules/pattern-analysis.md dependencies:
- scribe:voice-extract
- scribe:voice-generate
- scribe:voice-review
Voice Learning Skill
Learn from user edits to improve the voice profile over time.
When NOT To Use
- Building the first profile (use
scribe:voice-extract) - Reviewing text without changing the profile (use
scribe:voice-review)
Method: Three-Stage Comparison
Every piece flows through three stages:
- Pre-review: Raw generation output (before review agents)
- Post-review: After user accepts/rejects advisory fixes
- Post-edit: User's manually edited final version
The learning agent compares stages 2 and 3 (post-review vs post-edit) to identify patterns in what the user changed. These patterns inform register and rule updates.
Core Rules
- Sharpen, don't add: Modify existing rules to cover new patterns. Rule bloat degrades output.
- Tag specificity: Register-specific patterns go to registers. Universal patterns go to craft rules or agents.
- Flag contradictions: Opposite patterns across pieces require user resolution.
- Evidence threshold: Patterns need 3+ instances (or 1-2 matching existing accumulator entries) before becoming rules.
- Detection surface: Structural changes increase AI detectability. Craft-level changes are neutral. Prefer craft-level updates.
- Rule count check: Suggest consolidation if any section has 8+ rules.
Required Progress Items
voice-learn:snapshots-loaded- All three stages readvoice-learn:diff-analyzed- Changes categorizedvoice-learn:accumulator-checked- Prior patterns reviewedvoice-learn:proposals-generated- Updates proposedvoice-learn:user-approved- Changes accepted by user
Step 1: Load Snapshots
Load: @modules/snapshot-management
PROFILE_DIR="$HOME/.claude/voice-profiles/{name}"
SNAP_DIR="$PROFILE_DIR/learning/snapshots"
# Find the most recent snapshot set
# Format: {piece-name}-{timestamp}-{stage}.md
Read all three stages for the target piece.
Steps 2-4 need Opus or larger: telling a tone adjustment from a precision edit takes the nuance Sonnet flattens. When this session runs Sonnet or Haiku, run them as one dispatch:
Agent(general-purpose):
- model: opus
- prompt: {Steps 2-4 of this skill, the three snapshot paths,
and learning/accumulator.json}
The subagent sees nothing from this conversation and reads the snapshots from disk. It returns the proposals and does not write the profile. Step 5 approval stays in this session. On an Opus or Fable session, run the steps inline.
Step 2: Diff Analysis
Load: @modules/pattern-analysis
Compare post-review vs post-edit. Categorize every change:
| Category | Example | |----------|---------| | Tone adjustment | Softened a claim, added hedge | | Voice insertion | Added parenthetical, aside, humor | | Structure change | Broke paragraph, reordered | | Precision edit | Replaced vague with specific | | Deletion | Removed fluff or decoration | | Addition | Added context, example, anchor |
Step 3: Check Accumulator
Read learning/accumulator.json:
{
"patterns": [
{
"id": "pat-001",
"category": "tone_adjustment",
"description": "Softens confident claims about tool capabilities",
"instances": [
{"piece": "blog-post-1", "date": "2026-04-08", "diff": "..."}
],
"target": "register",
"status": "accumulating",
"first_seen": "2026-04-08",
"last_seen": "2026-04-08"
}
],
"staleness_threshold_days": 30
}
Match new changes against existing patterns:
- Semantic similarity (same category + similar description)
- If match found: merge instance, check if threshold reached
- If no match: create new accumulator entry
Step 4: Generate Proposals
For patterns that reach threshold (3+ instances or 1-2 matching prior accumulator entries with 2+ instances):
Apply (strong evidence)
## Proposed Update
**Pattern**: {description}
**Target**: {register file or craft-rules.md}
**Evidence**: {N instances across M pieces}
| Piece | Date | Change Made |
|-------|------|-------------|
| ... | ... | ... |
**Proposed edit**:
- File: {path}
- Section: {section name}
- Current: "{current text or 'new addition'}"
- Proposed: "{new text}"
Hold (insufficient evidence)
Add to accumulator with current instances. Report:
Holding: "{pattern description}" (N instances, need 3+)
Contradictions
If a new pattern contradicts an existing accumulator entry:
Contradiction detected:
- Existing: "{accumulator pattern}"
- New: "{contradicting pattern}"
- Resolution required: user must choose
Step 5: User Approval
Present proposals to user:
Learning found N patterns ready to apply:
[1] {pattern}: {proposed change}
Evidence: {N instances}
[a]pply / [s]kip / [v]iew evidence?
[2] ...
Apply approved changes to the target files.
Staleness
Patterns in the accumulator expire after staleness_threshold_days
(default 30). If a pattern hasn't recurred within that window,
it was likely a one-off preference rather than a voice trait.
On each learning pass, prune stale entries:
# Remove patterns older than threshold with < 3 instances
Snapshot Capture
The learning system captures snapshots automatically when voice-review completes. Snapshot naming:
{piece-filename}-{YYYYMMDD-HHMMSS}-pre-review.md
{piece-filename}-{YYYYMMDD-HHMMSS}-post-review.md
{piece-filename}-{YYYYMMDD-HHMMSS}-post-edit.md
The post-edit snapshot is captured when the user runs
/voice-learn after finishing their manual edits.
Exit Criteria
- [ ] Snapshots loaded and compared
- [ ] Changes categorized
- [ ] Accumulator checked and updated
- [ ] Proposals generated for threshold patterns
- [ ] User approved/rejected proposals
- [ ] Approved changes applied to profile files
- [ ] Stale accumulator entries pruned
Related Skills
LocalAI
50.5kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
