writing-voice SKILL.md skillA

writing-voice from seedcord/seedcord is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add seedcord/seedcord/writing-voice@git:20261021.958c08c

Pins git:20261021.958c08c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
seedcord/seedcord
Path
.agents/skills/writing-voice/SKILL.md
Versions recorded
5
Latest version
git:20261021.958c08c, committed Oct 21, 2026
First version recorded
Oct 7, 2026
Size
22,293 bytes
Repository stars
26
License
Apache-2.0

Use this when writing or reviewing any prose - docs, READMEs, code comments, commit messages, PR descriptions, changesets, and chat replies. Defines plain words over compressed abstractions, verbs over invented nouns, a test for anthropomorphism you can apply to any verb, the punctuation bans, and a hype ban-list.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Writing Voice

Write the sentence you would say out loud to another developer. Then check it against the rules below.

This covers everything a human reads. A field description, a `//` comment, a commit body, a changeset, a PR, and a reply in chat all get the same voice.

---

## 1. Plain words beat short words

This is the rule that matters most and the one that gets broken most.

An abstract phrase is shorter than the plain sentence it replaces. Any rule that rewards brevity will pull you toward abstraction. Resist it. **Cut whole ideas. Keep common words.**

A sentence improves when you cut a point the reader did not need. A sentence gets worse when you compress a point into a technical-sounding noun phrase. The second one looks like editing and is the opposite of it.

Real failures, all written by an assistant explaining its own behavior:

<!--prettier-ignore-start-->

| Compressed | Plain |
|---|---|
| local optimum, global monotony | every comment passes on its own. the file reads like one sentence repeated. |
| per-comment conformance | every comment matching the rules |
| the gradient toward variety is zero | nothing pushes toward variety |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add seedcord/seedcord/writing-voice@sha256:2c725a42bd2a38cb

The line at the top of this page pins the label git:20261021.958c08c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f3czoqxjphdq6zdt.svg)](https://markdownregistry.com/a/art_f3czoqxjphdq6zdt)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 7, 2026 and Oct 21, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261021.958c08c latest2026-10-21 958c08c 22,293 BA view · diff
git:20261021.1a581282026-10-21 1a58128 22,099 BA view · diff
git:20261021.b3d661a2026-10-21 b3d661a 22,013 BA view · diff
git:20261021.15afeef2026-10-21 15afeef 21,290 BA view · diff
git:20261007.971bc2b2026-10-07 971bc2b 20,190 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (22293 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

seedcord/seedcord · 26 stars · license Apache-2.0 · pushed 2026-10-22 · branch next

API

GET https://markdownregistry.com/api/v1/artifacts/art_f3czoqxjphdq6zdt
GET https://markdownregistry.com/api/v1/resolve?ref=seedcord/seedcord/writing-voice
GET https://markdownregistry.com/api/v1/blob/2c725a42bd2a38cb633768bb03a2694d061f99dbb9aa54dd4319cf234cb48014

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from seedcord/seedcord

changeset-guidelines SKILL.md skill
seedcord/seedcord · .agents/skills/changeset-guidelines/SKILL.md · Use this when writing or reviewing a changeset in `.changeset/*.md`. Covers how behavior decides the release type, the…
git:20261015.48dacfe · audit A · 26 stars
code-commenting-guidelines SKILL.md skill
seedcord/seedcord · .agents/skills/code-commenting-guidelines/SKILL.md · Use this when writing, refactoring, or reviewing TypeScript code. Decides whether a comment should exist at all, which…
git:20261021.1a58128 · audit A · 26 stars
code-quality SKILL.md skill
seedcord/seedcord · .agents/skills/code-quality/SKILL.md · Use this when asked to write code, or audit, sweep, or fix code quality across the seedcord monorepo. Covers the React…
git:20261007.971bc2b · audit A · 26 stars
envapt SKILL.md skill
seedcord/seedcord · .agents/skills/envapt/SKILL.md · Reads typed, validated config from process.env, .env files, or any bound source for TypeScript and JavaScript with the…
git:20261019.99e7d64 · audit A · 26 stars
guide-voice SKILL.md skill
seedcord/seedcord · .agents/skills/guide-voice/SKILL.md · Use this when writing or reviewing a page of the seedcord guide, anything under apps/guide/content. Covers how a page…
git:20261020.e57e1e6 · audit A · 26 stars
release-docs SKILL.md skill
seedcord/seedcord · .agents/skills/release-docs/SKILL.md · Bring every user-facing surface up to date for a seedcord release (changesets, READMEs, the home page, then the guide)…
git:20261020.e57e1e6 · audit A · 26 stars
release-version SKILL.md skill
seedcord/seedcord · .agents/skills/release-version/SKILL.md · Release seedcord's packages through changesets pre mode. Cut a prerelease from the long-lived `next` branch, graduate…
git:20261021.15afeef · audit A · 26 stars
tdd SKILL.md skill
seedcord/seedcord · .agents/skills/tdd/SKILL.md · Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD…
git:20261007.971bc2b · audit A · 26 stars
test-performance SKILL.md skill
seedcord/seedcord · .agents/skills/test-performance/SKILL.md · Use this when writing or changing a test, a test helper, or a vitest config in seedcord, and when a test is slow or…
git:20261015.dc45e41 · audit A · 26 stars
AGENTS.md AGENTS.md file
seedcord/seedcord · AGENTS.md
git:20261021.958c08c · audit B · 26 stars
CLAUDE.md CLAUDE.md file
seedcord/seedcord · CLAUDE.md
git:20260920.5590de4 · audit B · 26 stars
AGENTS.md@apps AGENTS.md file
seedcord/seedcord · apps/AGENTS.md
git:20260817.c343f4a · audit A · 26 stars

Every file in seedcord/seedcord

Other files named writing-voice

writing-voice SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/writing-voice/SKILL.md · Learn the operator's writing voice from samples they provide and save it as a reusable style profile, so drafts written…
git:20260912.42516ad · audit A · 14 stars

Browse by kind, by grade A, or by owner.