Agent skill

Line Editing

by danjdewhurst in danjdewhurst/story-skills

This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check…

MITAuto-check: notesWriting & Content

Install Line Editing

skills CLI
$ npx skills add danjdewhurst/story-skills --skill line-editing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install danjdewhurst/story-skills line-editing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/danjdewhurst/story-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/line-editing .claude/skills/line-editing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
line-editing
GitHub stars
279
Used in
1 other repo
Token cost
~3.1k tokens
SKILL.md length
1,642 words
Files
6 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check…

  • Works in 7 steps: Scope and permission → Line edit → Differentiate character voices → …
  • Asks to line edit
  • SKILL.md covers Overview, Prerequisites, Language and When to Use, plus 5 more sections
  • Calls node

What it does

Line Editing is an agent skill from danjdewhurst/story-skills. This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check grammar and punctuation", "dialogue punctuation", "make the voices distinct", "everyone sounds the same", "read it aloud", "read-aloud pass", "text to speech", or wants a sentence-level quality pass on drafted chapters that preserves the author's voice. NOT for creating the style sheet, recording character voices, or…

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/copyedit-checklist.md`, `references/edit-note-format.md` and `references/language-conventions.md`).

It sits in Writing & Content, covering Copy editing and proofreading and Text to speech and voice. The repository describes itself as: Agent Skills for end-to-end story writing in markdown, packaged as Codex and Claude Code plugins. The licence is MIT.

When your agent uses it

  • Asks to line edit
  • Polish this chapter
  • Tighten the prose
  • Improve the sentences

Example prompts

  • “line edit”
  • “edit my prose”
  • “polish this chapter”
  • “/line-editing”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Scope and permission
  2. Line edit
  3. Differentiate character voices
  4. Copyedit
  5. Read-aloud pass
  6. Proof pass
  7. Close the pass

What it can do on your machine

Read from SKILL.md and the folder at commit 1df23f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Line Editing loads about 3.1k tokens when it runs, and up to ~8.6k if it reads all its reference files. Until then it costs about 143 tokens; SKILL.md has 1,642 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~143
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:213
    `.env`, and a package script runs from the checkout's root. If no CLI is

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from danjdewhurst/story-skills at commit 1df23f9, republished under its MIT licence (© danjdewhurst). 1,642 words, ~3,133 tokens.

Download SKILL.mdSave it as .claude/skills/line-editing/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
line-editing
description
This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check grammar and punctuation", "dialogue punctuation", "make the voices distinct", "everyone sounds the same", "read it aloud", "read-aloud pass", "text to speech", or wants a sentence-level quality pass on drafted chapters that preserves the author's voice. NOT for creating the style sheet, recording character voices, or checking voice consistency (use voice-style).

Line Editing

Overview

Own the prose-quality passes that come after structure is settled: the line edit (sentence clarity, rhythm, precision, voice), character-voice differentiation, the copyedit against style-sheet.md, a read-aloud pass, and a proof pass on a built copy. Every change is proposed with a before/after and a one-line rationale so the author can accept or reject it. The author's voice is the standard, not the agent's taste. The better-writing skill, when installed, is an optional complement for anti-generic checks; this skill does not depend on it.

Prerequisites

A story project with story.md and drafted chapters (status draft or later). Read style-sheet.md if present; if it is missing or thin, build it first with the voice-style skill, because the copyedit checks against it.

Language

Read language in story.md (a BCP 47 tag such as en-GB, fr, or ja; a missing field means en). Edit in that language and to its grammar and conventions, and write edit notes in the language the user works in with you, quoting the prose exactly as written. The checklists' word-level advice (filter words, -ly adverbs, said, dialogue punctuation) is English: for another language, apply its aim, not its word lists, and take dialogue and punctuation from the style sheet and references/language-conventions.md. When story prose or story voices reports a check skipped for the book's language, or a check plainly does not fit it, do that pass by reading.

When to Use

  • A chapter's structure is settled and the prose needs polish
  • Dialogue sounds the same from every speaker
  • Preparing a manuscript for beta readers, an editor, or submission
  • The line, copyedit, or proof revision pass is next in story passes
  • NOT for structural, plot, or continuity revision (use revision-continuity; line-edit only after those passes, or the polish is wasted)
  • NOT for setting house style, the voice description, or each character's recorded voice (use voice-style; this skill applies them)
  • NOT for scene-level craft such as deep POV, subtext, or exposition strategy (use scene-craft)
  • NOT for acting on external reader notes (use feedback-triage)
  • NOT for writing or scanning verse (use verse-craft); this skill only flags rhymes that slipped into prose by accident

Workflow

1. Scope and permission
  1. Ask which chapters and which pass: line edit, voice differentiation, copyedit, read-aloud, or proof. Default order is the one below.
  2. Ask how heavy the edit should be: light (errors and clear improvements only), medium (tighten and clarify), or heavy (restructure sentences and paragraphs). Default to light.
  3. Never rewrite a passage wholesale without explicit permission. Propose edits; apply only what the author accepts, or apply all on explicit instruction.
  4. Snapshot before a multi-chapter pass (see Draft Snapshots in the revision-continuity skill), and mark the pass in progress. If story.md has no revision-passes yet, story passes . --init writes the default ladder first; story passes . shows where the book is.
shell
story passes . --start line
2. Line edit
  1. Read story.md (POV, tense, Tone & Style), the style sheet's Voice section, and the chapter. Run story prose . for the chapter's counts. If the style sheet has no samples, suggest the author list an earlier book or chapter files they are happy with (see the voice-style skill), so the counts are measured against their own voice. A prose-baseline-* warning shows where a chapter drifts from it: use it to find passages to reread, and keep any drift the author meant.
  2. Work paragraph by paragraph with references/line-edit-checklist.md: clarity, precision, economy, rhythm, POV distance, and voice.
  3. Present edits in the format in references/edit-note-format.md: location, before, after, and one line of rationale. Group by paragraph; lead with the highest-impact changes; cap a batch at about 20 so the author can review them.
  4. Leave passages that are unusual but deliberate. When unsure whether a quirk is voice or error, ask.
  5. To check a rewritten passage before putting it in the chapter, pipe it in: story prose - < rewrite.md lints it against the style sheet, and story voices - < rewrite.md checks its dialogue against the characters' voice-avoid lists.
3. Differentiate character voices
shell
story voices .

The report fingerprints each character's attributed dialogue (sentence length, contractions, questions, exclamations, signature words) and warns when two voices are near-identical, when a character says a voice-avoid word, and when a voice-words entry never appears.

  1. For near-identical pairs, read both characters' Voice & Speech Patterns sections and propose line-level changes that follow them: vocabulary, sentence length, what each avoids saying, how each deflects. See the voice section of references/line-edit-checklist.md.
  2. If a character file has no voice notes, propose voice-words and voice-avoid lists drawn from their best existing lines, and ask before adding them to the character file.
  3. A line counts only when the narration names its speaker by a speech verb, or names one character in the paragraph. Pronoun tags (she said) and untagged lines are invisible to the report, so the POV character in close third is often under-counted; read those lines by hand, or name the tags in a sample chapter and rerun. story voices --help describes the command and, when story-maintenance is installed, the voices section of ../story-maintenance/references/continuity-checks.md gives the full attribution rules and thresholds.
4. Copyedit
  1. Mark the pass: story passes . --start copyedit.
  2. Run story prose . and fix every avoided spelling. Then work through references/copyedit-checklist.md against style-sheet.md: grammar, punctuation, dialogue punctuation, capitalisation, hyphenation, numbers, and consistency of names and terms (check the glossary). For a book not in English, take dialogue and punctuation conventions from references/language-conventions.md; if the style sheet has not recorded them, settle them with the author first.
  3. Record every new decision in style-sheet.md in the same change, so the next chapter follows it.
  4. Tell the user plainly: this is a consistency and correctness pass, not a substitute for a professional copyeditor on a book going to print.
Show full SKILL.md (698 more words)Show less
5. Read-aloud pass

Follow references/read-aloud-guide.md. Build the narration script:

shell
story build . --format narration

Offer to play chapters with the system's text-to-speech if one is installed (say on macOS; espeak-ng or spd-say on Linux). Check with command -v; ask before installing anything. Choose a voice for the book's language (say -v '?' and espeak-ng --voices list them); an English voice reading another language is no test of the prose. Listen for stumbles, unintended rhymes, tongue-twisters, and runs of same-length sentences; record them as edit notes.

6. Proof pass
  1. Mark the pass: story passes . --start proof.
  2. Build the copy the reader will see:
shell
story build . --format html
story build . --format print --trim 6x9
  1. Proof against references/copyedit-checklist.md's proof section: typos introduced by editing, doubled or missing words, broken scene breaks, chapter headings, matter pages, widows and orphans in the print copy. Cite locations by the HTML copy's paragraph anchors (ch03-p12).

  2. To proof the print copy as a PDF, add --pdf to the print build:

    shell
    story build . --format print --trim 6x9 --pdf

    It finds and runs a paged-media engine the user has installed (Prince, WeasyPrint, pagedjs-cli, or Chrome as a fallback) and writes dist/<story-id>.pdf. Name an engine with --pdf-engine <name|path>. With none installed it stops (exit 4) and lists what to install; the CLI bundles none. Ask before installing anything.

7. Close the pass
  1. Summarise what changed, what was kept on purpose, and any style-sheet or character-file updates.
  2. Update chapter status only when the author agrees (draft to revised).
  3. Mark the pass done, for example story passes . --done line, and run CLI Maintenance.

Conventions

  • The author's voice wins. Edit toward what the prose is already trying to do, not toward a generic "good prose" standard.
  • One rationale line per change, naming the effect (clearer subject, cuts a filter word, restores past tense), never "sounds better".
  • Edits are made directly in the chapter markdown, below ## Chapter Text; never through a script that rewrites prose in bulk.
  • Style decisions go in style-sheet.md; voice decisions about a character go in the character file (voice-words, voice-avoid, Voice & Speech Patterns), which stays canon.
  • A line edit does not change events, facts, or who knows what. If an edit would, stop and hand it to revision-continuity.

CLI Maintenance

Use the Story CLI when it is available. If story is not installed, use the bundled fallback node ../story-maintenance/scripts/story.js with the same arguments. Use node <checkout>/bin/story.js instead only when the user names a Story Skills repository checkout or you are working in one. Write the script as an absolute path (resolve the fallback relative to this skill folder) and run it from the folder you would run story from, so . and other relative paths keep their meaning. Use Node, not Bun or a package script: Bun would load that folder's bunfig.toml (which can run code) and .env, and a package script runs from the checkout's root. If no CLI is available, apply the checklists by reading and keep word counts current by hand.

After editing chapters, character voice fields, or the style sheet:

shell
story reindex .
story wordcount . --write
story check .
story prose .
story voices .

Reference Files

  • references/line-edit-checklist.md - Paragraph-level line edit checks (clarity, precision, economy, rhythm, POV distance, voice) and character-voice differentiation levers
  • references/copyedit-checklist.md - Copyedit and proof checks against the style sheet: grammar, punctuation, dialogue punctuation, consistency, and the proof pass on built copies
  • references/read-aloud-guide.md - Running a read-aloud pass with the narration build and OS text-to-speech, and what to listen for
  • references/language-conventions.md - Dialogue and punctuation conventions by language (quote marks, dialogue dashes, spacing before punctuation, Spanish ¿¡, CJK brackets), and how to record them in the style sheet
  • references/edit-note-format.md - How to present edits to the author: before/after with rationale, batching, and recording accepted and rejected changes

Shared Conventions

Every story skill follows the shared conventions in ../story-maintenance/references/conventions.md, resolved relative to this skill folder. Read it before creating, renaming, or linking story files. If that file is missing because this skill was installed without story-maintenance, the essentials are: kebab-case ids and filenames, YAML frontmatter on every story-project file, _index.md registry tables that story reindex rebuilds (never edit them by hand), bidirectional links between entities, characters for who is on the page and mentions for who is only referred to, status: deceased plus died-in: chapter-{NN} for deaths, and no project-local generator or build scripts (run only the installed or bundled Story CLI).

© danjdewhurst, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/line-editing of danjdewhurst/story-skills.

  • SKILL.md
  • references/copyedit-checklist.md
  • references/edit-note-format.md
  • references/language-conventions.md
  • references/line-edit-checklist.md
  • references/read-aloud-guide.md

Open the folder on GitHubat commit 1df23f9

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in danjdewhurst/story-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Line Editing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Line Editing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Line Editing this skilldanjdewhurst/story-skills2791 repos~3.1kAutomated safety check: NotesMIT
Video TranslatorInsiderX-Pro/video-translator928—~635Automated safety check: PassMIT
Video Scriptzenstory-ai/oh-story-dsh466—~2kAutomated safety check: PassMIT
Create Librarybarefootford/buttercut601—~1.3kAutomated safety check: PassCustom licence
Pixi Vn CharactersDRincs-Productions/pixi-vn149—~3.1kAutomated safety check: PassLGPL-2.1
Proofreadsonilo-ai/skills1151 repos~4.3kAutomated safety check: NotesMIT

Similar skills

  • Video Translator

    InsiderX-Pro/video-translator

    Real time video translation / dubbing skill. An agent skill from InsiderX-Pro/video-translator.

    928 GitHub stars~635 tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Video Script

    zenstory-ai/oh-story-dsh

    对已完成分析的视频进行导演与剪辑策划,再写带时间戳的中文解说并校验;也处理已有短片的 宣发标题、花字修订和外部文案回填。普通策划输入 workdir 的 agentnarrationbrief.md 与 vlmanalysis.json;文案返修输入当前成片的工程与内容证据。策划输出 recapstoryplan.json、visualaudioboard.json、 可选…

    466 GitHub stars~2k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Create Library

    barefootford/buttercut

    Create a new ButterCut library. An agent skill from barefootford/buttercut.

    601 GitHub stars~1.3k tokensUpdated 15 days ago
    Writing & ContentAuto-check passed
  • Pixi Vn Characters

    DRincs-Productions/pixi-vn

    A skill your agent uses when defining visual novel characters for a @drincs/pixi-vn game — creating a character with a name, color, icon and other props, registering it so it can be looked up by id…

    149 GitHub stars~3.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Proofread

    sonilo-ai/skills

    Transcribe a video with Sonilo and translate the transcript into editable .srt files — one per target language, plus the detected source language — so the wording can be read and corrected before…

    115 GitHub starsUsed in 1 repo~4.3k tokens
    Media & CreativeAuto-check: notes
  • Task Recovery

    sonilo-ai/skills

    Recover the result of a timed-out Sonilo generation call using its taskid.

    115 GitHub starsUsed in 1 repo~2.1k tokens
    Media & CreativeAuto-check: notes

More from danjdewhurst/story-skills

All 24 skills in this repo
  • Adaptation

    danjdewhurst/story-skills

    This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay"…

    279 GitHub starsUsed in 2 repos~3.5k tokens
    Auto-check: notes
  • Story Maintenance

    danjdewhurst/story-skills

    This skill should be used when the user asks to "validate", "reindex", "repair registries", "check links", "run the continuity, pacing, clue, voice, or name checks", "count words", "summarize a…

    279 GitHub starsUsed in 1 repo~5.4k tokens
    Auto-check: notes
  • Research

    danjdewhurst/story-skills

    This skill should be used when the user asks to "research", "fact-check", "check the history", "is this accurate", "research notes", "sources", "historical accuracy", "technical accuracy", "how…

    279 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check: notes
  • Chapter Writing

    danjdewhurst/story-skills

    This skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter", "continue the story", "write a scene", "outline a chapter", or wants to write…

    279 GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check: notes
  • Character Management

    danjdewhurst/story-skills

    This skill should be used when the user asks to "create a character", "update a character", "add a character", "build a family tree", "character relationships", "character timeline", "character…

    279 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check: notes
  • Discovery Drafting

    danjdewhurst/story-skills

    This skill should be used when the user asks about "pantsing", "discovery write", "write without an outline", "discovery draft", "write into the dark", "story kernel", "reconcile a chapter", "dead…

    279 GitHub starsUsed in 1 repo~2k tokens
    Auto-check: notes

Questions about Line Editing

What does Line Editing do?

This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check…. Line Editing is an agent skill from danjdewhurst/story-skills. This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the prose", "improve the sentences", "copyedit", "proofread", "proof pass", "check grammar and punctuation", "dialogue punctuation", "make the voices distinct", "everyone sounds the same", "read it aloud", "read-aloud pass", "text to speech", or wants a sentence-level quality pass on drafted chapters that preserves the author's voice.

When should I use Line Editing?

Line Editing fits situations like: asks to line edit; polish this chapter; tighten the prose; improve the sentences.

How do I install Line Editing in Claude Code?

Run `npx skills add danjdewhurst/story-skills --skill line-editing -a claude-code`. Or copy the skill folder (skills/line-editing in danjdewhurst/story-skills) into .claude/skills/line-editing in your project. Claude Code loads it when a task matches its description.

How do I install Line Editing in Codex?

Run `npx skills add danjdewhurst/story-skills --skill line-editing -a codex`. Or copy the skill folder (skills/line-editing in danjdewhurst/story-skills) into .agents/skills/line-editing in your project. Codex loads it when a task matches its description.

Can I use Line Editing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add danjdewhurst/story-skills --skill line-editing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/line-editing, .gemini/skills/line-editing, .github/skills/line-editing and .opencode/skills/line-editing in your project.

What does Line Editing need to run?

Going by SKILL.md and its folder, Line Editing needs the command-line tools its instructions call (node).

Does Line Editing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Line Editing safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Line Editing use?

Line Editing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Line Editing use?

About 3.1k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Line Editing?

Skills that share tags, products or a category with Line Editing: Video Translator (InsiderX-Pro/video-translator, 928 stars), Video Script (zenstory-ai/oh-story-dsh, 466 stars), Create Library (barefootford/buttercut, 601 stars) and Pixi Vn Characters (DRincs-Productions/pixi-vn, 149 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Line Editing?

danjdewhurst (a GitHub user) maintains it in danjdewhurst/story-skills, which has 279 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

Source: danjdewhurst/story-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.