human-voice
Skill4 starsChanged 29 days agoMITView on GitHub
Rules for Russian text a human will read: what makes agency output sound machine-written, and which of those rules survive a change of medium. Covers intake questions, chat replies, lead plans, manager verdicts, consilium summaries, human-readable docs and RU copy. Applies as a constraint on generation, not as a rewriting pass over finished text.
12 other projects use a version of this.
Adopted by
Most recently taken up by
- heypastel/pastel-outbound-systemtheir own version, first seen Nov 8, 2026
- Tcuzzo/backs-aios-skillstheir own version, first seen Nov 3, 2026
- ttilabs11-byte/human-voice-skilltheir own version, first seen Oct 25, 2026
- jameskrupnik/indie-app-skillstheir own version, first seen Oct 15, 2026
- mike22890/opencode-skills-entheir own version, first seen Oct 15, 2026
- 0King0P/Claude-Skillstheir own version, first seen Oct 13, 2026
Other versions12 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 12
- stephenoffer/human-voice★ 38same name
- ttilabs11-byte/human-voice-skill★ 7same name
- Envy-7z/katalyst★ 4same name
- ksprashu/agent-skill-forge★ 3same name
- heypastel/pastel-outbound-system★ 2same name
- Tcuzzo/backs-aios-skills★ 2same name
- DavoDC/claude-playbook★ 1same name
- Jawahars07/ballast★ 1same name
- mike22890/opencode-skills-cn★ 1same name
- mike22890/opencode-skills-en★ 1same name
2 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository48 other files it gives its agents.
- skills/dev-methodology/references/agents.mdAGENTS.md
- skills/skill-authoring/references/agents.mdAGENTS.md
- acceptance-protocolSkill
- agency-intakeSkill
- ai-visibility-methodologySkill
- banner-design-guideSkill
- benchmark-researchSkill
- brand-methodologySkill
- code-reviewingSkill
- code-writingSkill
- codex-bridgeSkill
- deploy-pipelineSkill
- design-assets-guideSkill
- design-system-methodologySkill
- design-task-decompositionSkill
- dev-methodologySkill
- docs-pipelineSkill
- documentation-writingSkill
- engagement-contractSkill
- engagement-protocolSkill
- feature-researchSkill
- infrastructure-setupSkill
- marketing-task-decompositionSkill
- post-deploy-qaSkill
- pre-deploy-qaSkill
- presentation-designSkill
- project-planningSkill
- prompt-engineeringSkill
- security-auditingSkill
- semantic-drift-methodologySkill
- seo-auditingSkill
- skill-authoringSkill
- skill-test-designSkill
- skill-testingSkill
- system-optimization-protocolSkill
- task-decompositionSkill
- tech-spec-planningSkill
- testing-methodologySkill
- ui-styling-guideSkill
- ui-ux-methodologySkill
- user-spec-planningSkill
- validation-pipelineSkill
- yandex-analytics-methodologySkill
- yandex-direct-guideSkill
- yandex-metrika-guideSkill
- yandex-search-guideSkill
- yandex-webmaster-guideSkill
- yandex-wordstat-guideSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 10 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 87
Write in sentences. Use colons, periods, commas and parentheses.
- Distinctive: line 115
Run it over your own archived engagements to get a baseline before trusting any rule.
“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
human-voice
Derived from the analysis of humanizer-ru
by Vladimir-Human (MIT). Its PERSONA.md and content patterns are the source of the reasoning
below. Its 40 forensic regexes (leaked service artefacts: turn0search0, 【1†source】,
zero-width characters) are deliberately not carried over: text here is generated inside agents
rather than pasted from a model's raw output, so those markers have nothing to match.
What this is for
Three failure modes, in order of how much damage they do:
- Text asserts something it has not earned. Softest signals get stated as verdicts.
- Text invents specifics. A number, date, name or unit appears that no source contained.
- Text is padded. Opening phrases with no content, moralising wrap-ups, degree adverbs standing in for measurements.
The third is the visible one and the least important. Fix it last.
Surfaces: which rules survive which medium
The trap in any borrowed voice guide is that it was written for dialogue. Rules like "no lists,
no headings, no bold" are right for chat and wrong for acceptance-log.md, where the list IS
the answer. Match the rule to the medium.
| surface | what it is | rules that apply |
| chat, RU copy for an outside reader | replies to the user, README, landing, pitch, letters | everything below, including shape and dashes |
| plans, verdicts, summaries | plan.md, acceptance-log.md, consilium-summary.md, handoffs | substance rules only: no padding, no unearned claims, no invented specifics. Structure stays: lists, headings and bold are how these documents work |
| technical docs | project-knowledge, docs-pipeline output | substance rules only, plus "facts before style". Nothing about conversational tone |
| specialist prompts | task text handed to a dispatched agent | the invented-specifics rule, as a hard refusal |
Internal notes a person writes for themselves are not a target surface at all.
The rules
Claim only what the text can show
State what was checked and what it showed. When the signal is soft, say it is soft and name
what a check would settle. Certainty adverbs (очевидно, что, безусловно, несомненно,
разумеется) assert a proof that is not on the page; either the proof exists, in which case
cite it, or the sentence is a guess wearing a verdict's clothes. однозначно is deliberately
absent: in technical Russian it usually means "deterministically", as in однозначно определяем
маршрут по заголовку, and flagging that reads as pedantry rather than help.
The source guide puts this best in its own domain: soft signals give no verdict about authorship. Three matched patterns earn "worth checking by hand", not "written by a machine".
Invent no specifics
A number, date, name, title or unit that was not in the source does not appear in the output. This holds hardest in specialist prompts, where a plausible invented figure survives review precisely because it is plausible. When a figure is needed and absent, say it is absent.
Cut the padding
- Openings that carry nothing:
важно отметить,стоит отметить,следует учитывать,как известно. Begin with the fact instead. - Moralising closings:
в конечном счёте,подводя итог,таким образом, можно сделать вывод. End on the last fact. - Bureaucratic connectives:
является,осуществляется,представляет собой, demonstrativeданный,на сегодняшний день. Name the actor and the verb. - Degree adverbs used as measurements:
значительно,существенно,кардинально,полностью. Give the number, or drop the adverb. - Quality claims with no observable criterion:
работает корректно,удобный интерфейс,улучшить UX,повысить эффективность. State what is measured and how it is checked. - Stock phrases that read as machine-written:
бесшовно,из коробки,на лету,в современном мире,ключевая особенность,под капотом,не чёрный ящик,помогает, а не заменяет,в связке с человеком.
Shape, on the chat and RU-copy surface only
Write in sentences. Use colons, periods, commas and parentheses; em and en dashes in Russian prose read as a machine stamp. Avoid triads assembled for rhythm. Avoid marketing superlatives.
This section stops at the surface boundary. Applying it to a structured document produces a document that visibly avoids something, which is its own tell.
What is deliberately absent
- Counting rules. "No more than one dash per answer" targets a symptom. Applied mechanically it makes text that is conspicuously avoiding a character. Carry causes, not counts.
- A rewriting pass. Nothing here runs over a finished answer to improve it. A second author with no responsibility for the content is exactly what an earlier pipeline rejected: one step, one judgement. These rules constrain generation and inform review; they never post-process.
- Dialogue-shape rules for documents. See the surface table.
Measuring, before trusting
Rules that fire on nothing are dead weight. Rules that fire on everything describe the language rather than the text. Check with the detector from voice-check.py, which reports hits per 1000 Russian prose lines and never edits anything:
python ~/.claude/skills/human-voice/scripts/voice-check.py <path> --surface artefactRun it over your own archived engagements to get a baseline before trusting any rule.
What the output is: a hit count over the detector's own filtered sample. It is not precision, not recall, and it was never compared against human-labelled Russian. The denominator moves with formatting alone (table rows and indented code are stripped), so the same text can give a different rate after a reformat. Treat the number as a way to see whether a rule is alive, and nothing more.
A rule that scores zero on dense engineering prose is unexercised rather than proven harmless: that is not the surface most of these rules were written for. The dash rule is excluded from the artefact surface entirely, because there almost every hit is a structural dash after a bold lead-in.
Negative fixture: a hand-written brief in plain Russian should score 0 on the artefact surface. The detector strips quoted material, so a table that quotes the banned phrases does not count against the text that quotes them.
Anti-patterns
- Rewriting a finished answer to comply. Generate in this voice instead.
- Applying dash and shape rules to
acceptance-log.md, a tech-spec or a handoff. - Reporting a hit count as a quality score. The detector locates candidates; a person decides.
- Removing a fact because its phrasing tripped a rule. Rephrase and keep the fact.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

