beat-writer
Skill36 starsChanged 53 days agoMITView on GitHub
Channel-agnostic writer for any piece of content that doesn't yet belong to a specific channel. Use when you have something to say but don't know where it goes — could become a blog post, X thread, newsletter section, web copy, journal entry, or just stay as a plain doc. Runs the beat extraction + shaping discipline, pours prose via /authors-voice (with the operator's default anchor — personal voice), polishes, and leaves a clean draft in OpenWriter. The draft can later be refactored into a specific channel via /blog-writer, /x-writer, or /newsletter-writer.
In this repository6 other files it gives its agents.
- anti-aiSkill
- blog-writerSkill
- book-writerSkill
- newsletter-writerSkill
- polishSkill
- x-writerSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 56
Refactor is optional: When a draft's destination becomes obvious, hand off to the appropriate channel-master (/blog-writer, /x-writer, …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Beat Writer
Channel-agnostic, beats-first writer for uncommitted drafts. Owns extraction + shaping; delegates prose to /authors-voice (operator's default anchor — personal voice). Output is a plain OpenWriter doc that can stay generic OR get refactored later into a specific channel via a channel-master writer.
4-layer model:
- EXTRACT — pull beats out of the operator. Same query-first, 5-pass discipline used by
/book-writer. Channel-agnostic CATEGORY tags (CLAIM / REFRAME / MECHANISM / EVIDENCE / STORY / APHORISM / PIVOT / OBJECTION).docs/extraction.md - SHAPE — order beats by reader flow, lock as commitments (no content prescription). No channel template — just a sequenced beats list.
docs/beat-method.md - VOICE —
/authors-voiceApply Protocol with the operator's DEFAULT anchor (personal voice). Same machinery as every other writer; no anchor swap. The piece sounds like the operator. - POLISH —
/polishto 90/100, then/anti-ai, then a naive-reader pass (/congruenceif installed, otherwise inline). Delegated, not duplicated.
Firm rules
- Single entry point. Invoked as
/beat-writeronly. No subcommands, no flag-syntax args. Internal dispatch from context. - EXTRACT before WRITE. Same query-first discipline as
/book-writer. AI never invents beats; the operator's head is the source. - Beats are commitments, not content. Each beat names the OUTCOME (what the reader registers / what shift lands). The voice layer brings the words.
- No channel template. This skill deliberately does NOT impose a page structure, thread shape, post format, or chapter container. The draft is shapeless-by-design (just a sequenced beat list) so any channel-master can later re-shape it.
- Voice =
/authors-voiceApply Protocol with operator's DEFAULT anchor. Same machine, default fuel. The piece sounds like the operator. Editor never writes prose directly; every pour is a minion dispatch. Same Rule 1 as/authors-voice. - OpenWriter is the writing surface. One container per draft; Beats doc + Draft doc inside (same convention as
/blog-writer). Workspace:[Project] Drafts(or reuse the operator's existing writing workspace if present). - Refactor is optional. When a draft's destination becomes obvious, hand off to the appropriate channel-master (
/blog-writer,/x-writer,/newsletter-writer,/book-writer). Refactor doesn't move the draft; the channel-master reads the Beats + Draft docs and re-shapes into its own container. Seedocs/refactor.md. - Polish is delegated.
/polish→/anti-ai→ naive-reader pass (/congruenceif installed, otherwise read as a first-time reader and fix inline). Do not duplicate their logic.
Architecture
beat-writer/
├── SKILL.md (this file — router + firm rules + 4-layer model)
└── docs/ (loaded on routing match)
├── extraction.md (5-pass — channel-agnostic CATEGORY tags)
├── beat-method.md (beat = type + job + slot; commitments-not-content)
├── pipeline.md (extract → write → polish → anti-ai → congruence)
├── openwriter-surface.md (Drafts workspace + container + Beats/Draft doc pattern)
└── refactor.md (handoff to /blog-writer, /x-writer, /newsletter-writer, /book-writer)Routing
| User intent | Action |
| "/beat-writer" with no context | Ask ONE clarifying question: what are we writing about? |
| "draft something about X" / "write this" | Extract → shape → voice → polish |
| "I have this idea: [seed]" | Operator's dump = seed → 5-pass extraction → shape → write |
| "extract beats from [topic]" | Pass 1–5 only — no draft pour |
| "pour these beats: [list]" | Skip extraction; load beats; voice pour via /authors-voice |
| "polish this draft" | Skip extraction + write; run polish/anti-ai/congruence only |
| "make this into a blog/tweet/newsletter/page" | Refactor handoff — load draft + Beats, route to channel-master per docs/refactor.md |
Output contract
{
"status": "draft-ready" | "needs-input" | "blocked",
"artifact": { "doc_id": "...", "workspace_id": "...", "container_id": "..." },
"next_steps": ["polish", "anti-ai", "refactor-to-<channel>", "publish-via-channel-master"],
"notes": "<optional>"
}Companion skills
- /authors-voice — REQUIRED. Every prose pour delegates to its Apply Protocol with operator's default anchor.
- /polish — REQUIRED for the 90/100 push.
- /anti-ai — final fingerprint scrub after polish.
- /congruence — naive-reader pass for jargon / broken flow (optional; if not installed, do this pass inline).
- openwriter — REQUIRED. Beats + Draft docs live here.
- /blog-writer / /x-writer / /newsletter-writer / /book-writer — refactor targets when the draft's destination becomes clear.
What this skill does NOT cover
- Channel-specific shape — page templates, thread structure, blog post layout, email scaffolds, chapter containers. Those belong to channel-masters.
- Channel-specific constraints — character budgets per slot. Use
/x-writerfor tweet/article budgets. - Voice machinery —
/authors-voiceowns Apply Protocol, NEVER-rule patching, fingerprint audit, blinder audit. - Personal-voice setup —
/authors-voiceowns anchor setup, NEVER rules, fingerprints, corpus analysis. - Publishing — channel-master skills own publish mechanics.
When to skip this skill
- Known channel from the start — use the channel-master directly (
/blog-writer,/x-writer, etc.) - Single-paragraph or one-liner —
/authors-voicedirectly is faster - Pure ideation (no draft target) — talk it out, don't formalize it
- Polish-only on existing prose —
/polishdirectly
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.

