{ "schema": "aiblocks-page/1", "id": "long-form-draft-editor", "type": "agent", "name": "Long-form draft editor", "summary": "Edit a story, article or guide in rounds. Keep your meaning, record changes and stop when the writer must decide.", "headline": "Long-form draft editor", "subhead": "Share the full draft, its type and any reader notes or sources. It checks the piece, fixes wording and structure, then checks again for up to three rounds. You get a revised copy, change log and questions for you. Plot choices, unsupported facts and protected lines stay with the writer.", "job": { "id": "write-and-tell-stories", "name": "Write and tell stories" }, "level": "advanced", "thinking": "high", "tested": true, "updated": "2026-10-28", "first_published": "2026-10-21", "inputs": [ { "type": "copy_draft", "required": true, "label": "Copy draft", "what": "a draft of any copy (ad, page, email or script) that a check or edit pass works on" }, { "type": "brief", "required": false, "label": "Brief", "what": "a creative brief: goal, audience, angle, offer, mandatory claims (by ID), formats" }, { "type": "feedback_notes", "required": false, "label": "Feedback notes", "what": "a person's notes on an output: what to keep, change or drop" } ], "outputs": [ { "type": "copy_draft", "required": true, "label": "Copy draft", "what": "a draft of any copy (ad, page, email or script) that a check or edit pass works on" }, { "type": "audit_report", "required": true, "label": "Audit report", "what": "findings with evidence, severity, missing inputs and next actions" }, { "type": "feedback_notes", "required": true, "label": "Feedback notes", "what": "a person's notes on an output: what to keep, change or drop" } ], "you_give": [ "The whole draft in one file, and how long it has rested", "The kind of piece, a story or narrative or an article, guide or post", "The brief or word limit, if there is one (optional)", "First readers' notes (optional)", "The facts and sources the piece relies on, if it is an article (advised)" ], "you_get": [ "The edited draft, next to your untouched original", "Scores for each check at the start and after each round", "A log of every change, with the skill behind it", "A list of the problems left for you, with the page and the question to answer", "A question sheet to send to first readers" ], "use_when": [ "You have a finished draft that has rested and you want it tightened without losing your voice.", "You want to know which problems you must fix yourself and which an editor can fix for you.", "Your readers sent notes and you want a ranked list of what to fix first." ], "skip_when": [ "You want to edit an ad, sales page or email: use the Sales copy editor instead.", "Your draft is under about 1,000 words: one quick edit pass in your AI is enough, so skip the rounds.", "You want the agent to fix a plot hole or a wrong fact: that is your call, so decide it yourself or ask a trusted reader." ], "output_sample": { "input": [ "Your whole draft in one file, and how long it has rested", "The kind of piece: a story or narrative, or an article, guide or post", "The brief or word limit (optional)", "First readers' notes (optional)", "Your facts and sources, if it is an article (optional)" ], "prerequisites": [ "An AI that can save and read files, such as Claude Code, to keep the edit folder between rounds" ], "output": [ { "name": "The draft", "contains": "The latest round's file, next to your untouched original." }, { "name": "Scores by round", "contains": "Each check's result at the start and after each round." }, { "name": "Why it stopped", "contains": "Whether the draft passed, hit the round cap, reached your turn, or stopped making progress." }, { "name": "What changed", "contains": "Every change per round, with the skill that made it and the reason." }, { "name": "Yours to decide", "contains": "Each plot hole, out-of-character act or unsupported fact left, with the page and the question to answer." }, { "name": "Questions for first readers", "contains": "A question sheet to send to readers, or a note that it waits for your decisions." }, { "name": "Files and missing", "contains": "Each round's file, then every MISSING line in one list." } ] }, "output_shape": "THE DRAFT\n | original untouched: \n\nSCORES BY ROUND\n cold reread: -> -> \n story rules: -> -> \n (article: halt items -> | flags -> )\n\nWHY IT STOPPED\n \n\nWHAT CHANGED\n Round : | skill: | reason: \n\nYOURS TO DECIDE (most important first)\n : | question: \n\nQUESTIONS FOR FIRST READERS\n \n\nFILES AND MISSING\n | MISSING: ", "how_to_use": [ "Start a chat with the agent. In Claude Code, add it as a skill or save it in .claude/agents, then give it the draft file. If your AI cannot save files, paste the latest round and your kept-on-purpose list back in at the start of each round.", "Tell it the kind of piece and how long the draft has rested.", "Read the hand-back. Fix the problems on your list yourself.", "Send the draft to first readers with the question sheet. When their notes come in, run the agent again. It starts with their notes.", "Run it as many times as you like. It keeps a kept-on-purpose list, so it never undoes a choice you made." ], "checks": [ "Your original is untouched.", "The agent did not change a plot point, fact, quote or name.", "The scores shown are the ones the checks gave, with their sums.", "The cut ran once at most.", "Every change names the skill behind it." ], "steps": [ { "position": 1, "id": "reader-feedback-sorter", "name": "Reader feedback sorter", "summary": "Sort feedback from several readers into what to fix, what to leave alone and a ranked rewrite list for your next draft.", "url": "https://useaiblocks.com/skills/reader-feedback-sorter" }, { "position": 2, "id": "cold-reread-marker", "name": "Fresh draft reviewer", "summary": "Paste a rested draft. Get every page that needs a change, the big holes, and a score.", "url": "https://useaiblocks.com/skills/cold-reread-marker" }, { "position": 3, "id": "story-rules-checker", "name": "Story rules checker", "summary": "Paste a story. Get it checked against 18 plain-fiction rules, each fault named with its line, and a score.", "url": "https://useaiblocks.com/skills/story-rules-checker" }, { "position": 4, "id": "hidden-theme-finder", "name": "Story theme and scene reviewer", "summary": "Share a finished story draft. Find recurring details, compare possible themes and plan scene changes that make the strongest reading clearer.", "url": "https://useaiblocks.com/skills/hidden-theme-finder" }, { "position": 5, "id": "pre-publish-content-checker", "name": "Pre-publish content checker", "summary": "Share a draft, brief and source material. Get checks on claims, voice, structure and search details, with fixes and unresolved gaps.", "url": "https://useaiblocks.com/skills/pre-publish-content-checker" }, { "position": 6, "id": "ten-percent-cutter", "name": "Draft shortening editor", "summary": "Paste a long draft and cut 10 percent of its words. You get the shorter draft, a log of every cut and a check that the story still works.", "url": "https://useaiblocks.com/skills/ten-percent-cutter" }, { "position": 7, "id": "scene-want-and-tactic-rewriter", "name": "Character motivation scene editor", "summary": "Rewrite a flat scene so each person wants something and uses words to get it. Paste your dialogue and get a scene rewrite with a read-aloud check.", "url": "https://useaiblocks.com/skills/scene-want-and-tactic-rewriter" }, { "position": 8, "id": "show-dont-tell-scene-rewriter", "name": "Show-don't-tell scene rewriter", "summary": "Show, don't tell: paste a paragraph that names the feeling and get it rewritten in short, plain sentences, with every feeling word cut.", "url": "https://useaiblocks.com/skills/show-dont-tell-scene-rewriter" }, { "position": 9, "id": "dialogue-ear-checker", "name": "Dialogue editor", "summary": "Share a scene with speaker notes. Review natural speech, distinct voices, hidden explanation and dialogue tags, then get fixes and a checklist score.", "url": "https://useaiblocks.com/skills/dialogue-ear-checker" }, { "position": 10, "id": "plain-english-editor", "name": "Plain English editor", "summary": "Paste a draft and get it back in plain English, with every cut explained and a read-aloud check. Edit stiff emails, reports and pages.", "url": "https://useaiblocks.com/skills/plain-english-editor" }, { "position": 11, "id": "first-reader-question-writer", "name": "Reader feedback question writer", "summary": "Share your draft. Identify the right test reader and get questions that uncover where they struggle.", "url": "https://useaiblocks.com/skills/first-reader-question-writer" } ], "next": [ { "name": "Draft proofreader", "url": "https://useaiblocks.com/skills/draft-proofreader", "why": "Tell it as a story" }, { "name": "Article evidence and copy editor", "url": "https://useaiblocks.com/skills/blog-post-publish-check-loop", "why": "Tell it as a story" } ], "source": null, "credits": [], "files": [], "links": { "page": "https://useaiblocks.com/agents/long-form-draft-editor", "markdown": "https://useaiblocks.com/agents/long-form-draft-editor.md", "json": "https://useaiblocks.com/agents/long-form-draft-editor.json", "instructions": "https://useaiblocks.com/skills/long-form-draft-editor/SKILL.md", "api_item": "https://useaiblocks.com/api/v1/items/long-form-draft-editor", "api_document": "https://useaiblocks.com/api/v1/documents/agent/long-form-draft-editor", "mcp": "https://useaiblocks.com/mcp" } }