written-redraft
Skill2 starsChanged 22 days agoMITView on GitHub
Rewrite newsletter/blog drafts Jared sent back with feedback on Engage's /written page - reads each status:redraft file's note, rewrites the body to match it, and puts it back as a draft to re-approve. Use when Jared says /written-redraft, "process redrafts", "handle my written feedback", or when the /written page's Process redrafts button opens a terminal for it.
- Commits and pushes
In this repository15 other files it gives its agents.
- bankSkill
- build-toolSkill
- busy-workSkill
- freebieSkill
- idea-vetSkill
- linkedin-engageSkill
- make-skillSkill
- post-weekSkill
- seat-templateSkill
- ship-skillSkill
- sparSkill
- validate-accuracySkill
- vid-batchSkill
- week-planSkill
- x-engageSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 0 are distinctive, and 6 are 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.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 29
A community post follows different standards from step 3: Read buildlog/community/_template.md instead of voice.mjs's sales voice and …
- Very specific: line 50
Keep the frontmatter fields that aren't about status/note untouched (subject, weekOf, slot, title, format, cta, ...).
- Very specific: line 55
Write the file, matching the existing frontmatter style (|- block scalars where already used, canonical YAML).
- Very specific: line 69
Never set status: approved here.
- Very specific: line 71
Never fabricate a fact, a number, or a detail the note didn't supply and the file didn't already have, same rule /post-week follows when …
- Very specific: line 73
If a note is ambiguous or asks for something that contradicts content-pillars.md (pricing, a shelved product, a revenue claim), do not …
≈ “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
Redraft queue for newsletter/blog
Engage's /written page lets Jared leave a note instead of editing text himself. That note gets
written straight to buildlog as status: redraft and a note field, queued rather than acted on
instantly (his call, 2026-08-19: a real rewrite happening the moment he clicks submit needs an
LLM call inside that request, the same per-use API cost as buildlog's disabled Regenerate
button, which he already declined once). This skill is that queue's processor: a real Claude Code
session, run off his existing subscription, not a metered API call.
What this does NOT cover
Drafting the week's content from scratch is /post-week's job. This skill only rewrites entries
already sitting at status: redraft. If nothing is at that status, say so and stop; do not go
looking for other work to do.
Steps
- Fetch buildlog's origin first.
git -C <HOME>\projects\buildlog fetch origin && git -C <HOME>\projects\buildlog checkout main && git -C <HOME>\projects\buildlog pull --rebase. A stale checkout means rewriting a version of the file that already changed underneath it. Find every
status: redraftfile inbuildlog/src/content/newsletters/,buildlog/src/content/posts/andbuildlog/community/(The Back Office daily Skool posts, added 2026-09-12). If there are none, report that and stop, nothing to do.A community post follows different standards from step 3. Read
buildlog/community/_template.mdinstead ofvoice.mjs's sales voice andcontent-pillars.md: bar voice, 400 to 800 words, the four-part shape, Skool formatting (no bold, no headings), and the Wednesdaysourcerule. A rewrite that drops below 400 words, or adds a member question no source records, goes back atstatus: redraftwith the reason in the scoreboard instead of going out as a draft.- Read the standards before rewriting anything, same as
/post-weekdoes at drafting time:buildlog/scripts/voice.mjs- the sales voice (short declarative sentences, concrete numbers, problem then mechanism then result, no em/en dashes).buildlog/docs/content-pillars.md- the seven pillars and the product honesty guardrails. It names which products may be mentioned in a draft, at what price, and which are shelved and must never be named, priced or teased. Keep that list in your own repo.- Newsletters additionally follow the four-section format (Shipped, Broke, Steal this, Worth
knowing) documented in
content-pillars.md's "Newsletter format" section.
- For each redraft file, rewrite it to the note, literally. The note is the whole
instruction, the same rule
/post-weekfollows for a session-live redraft: read it literally and rewrite to it, not a soft version of it. If the note would change how every piece like this one should read (not just this one), say so in the scoreboard, but only apply it to the piece in front of you here.- Keep the frontmatter fields that aren't about status/note untouched (subject, weekOf, slot,
title, format, cta, ...). Only
statusandnotechange. - Set
status: draftand remove thenotefield entirely (delete the key, don't set it to empty string). It already lived in this commit's history if it needs to be found again, and leaving it would read as still-open feedback the next time this file is reviewed. - Write the file, matching the existing frontmatter style (
|-block scalars where already used, canonical YAML).
- Keep the frontmatter fields that aren't about status/note untouched (subject, weekOf, slot,
title, format, cta, ...). Only
- Commit and push once for the whole batch, not once per file.
git -C <HOME>\projects\buildlog add -A && git commit -m "written-redraft: rewrite N items per feedback" && git push. Fetch and--rebaseif the push rejects, sincebuildlog-publisher's own Actions push to this same remote on their own schedule. Never force. Then verify the push landed:git -C <HOME>\projects\buildlog log origin/main -1. - Report a scoreboard, one line per file: what the note asked for and what changed. Tell
Jared they're back at
/writtenwaiting for another look, same page, no other step needed.
Safety rails
- Never set
status: approvedhere. A redraft rewrite goes back todraft, always, even if the note reads like enthusiastic agreement. Only Jared approves, on/written. - Never fabricate a fact, a number, or a detail the note didn't supply and the file didn't
already have, same rule
/post-weekfollows when drafting. - If a note is ambiguous or asks for something that contradicts
content-pillars.md(pricing, a shelved product, a revenue claim), do not guess. Leave that one file atstatus: redraftand say why in the scoreboard rather than writing something wrong back as a draft.
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.

