User-Facing Text Cleanup
guillaumemeyer/watermarks-remover
Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.
Multi-pass revision - developmental editing, line editing, copy editing
Install Revise
$ npx skills add Ckokoski/AuthorAgent --skill revise -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Ckokoski/AuthorAgent revise --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/author/revise .claude/skills/revise && rm -rf skills-srcUse ~/.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/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .claude/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/reviseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Ckokoski/AuthorAgent --skill revise -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Ckokoski/AuthorAgent revise --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/author/revise .agents/skills/revise && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .agents/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Ckokoski/AuthorAgent --skill revise -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Ckokoski/AuthorAgent revise --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/author/revise .cursor/skills/revise && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .cursor/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Ckokoski/AuthorAgent.git --path skills/author/revise--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Ckokoski/AuthorAgent --skill revise -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Ckokoski/AuthorAgent revise --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/author/revise .gemini/skills/revise && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .gemini/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Ckokoski/AuthorAgent reviseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Ckokoski/AuthorAgent --skill revise -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/author/revise .github/skills/revise && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .github/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Ckokoski/AuthorAgent --skill revise -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Ckokoski/AuthorAgent revise --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/author/revise .opencode/skills/revise && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "revise" agent skill from https://github.com/Ckokoski/AuthorAgent/tree/main/skills/author/revise into .opencode/skills/revise/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "revise", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
revise- GitHub stars
- 124
- Token cost
- ~473 tokens
- SKILL.md length
- 189 words
- Files
- 1
- Skills in repo
- 23
- Repo updated
- First seen
- Licence
- MIT
At a glance
Multi-pass revision - developmental editing, line editing, copy editing
- Tasks that involve Copy editing and proofreading
- SKILL.md covers Revision Passes, Feedback Format and Rules
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Revise is an agent skill from Ckokoski/AuthorAgent. Multi-pass revision - developmental editing, line editing, copy editing
Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Writing & Content, covering Copy editing and proofreading. The repository describes itself as: The Autonomous AI Writing Agent — a secure, author-focused AI for fiction and nonfiction authors (Planning, Revision, Promotion, and more). The licence is MIT.
When your agent uses it
- Tasks that involve Copy editing and proofreading
Example prompts
- “/revise”
What it can do on your machine
Read from SKILL.md and the folder at commit 47e9570. 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
No scripts in the folder and no shell commands in SKILL.md.
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
Revise loads about 473 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 189 words of instructions outside code blocks.
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 passed
The automated check found no risky patterns in SKILL.md.
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 Ckokoski/AuthorAgent at commit 47e9570, republished under its MIT licence (© Ckokoski). 189 words, ~473 tokens.
Download SKILL.mdSave it as
.claude/skills/revise/SKILL.md (or your agent's skills folder).- name
- revise
- description
- Multi-pass revision - developmental editing, line editing, copy editing
- author
- AuthorAgent
- version
- 1.0.0
- triggers
- revise, edit, improve, rewrite, feedback, critique, review, developmental edit, line edit, copy edit
- permissions
- file:read, file:write
Revision Skill
Provide multi-layer editing support. Each pass serves a different purpose.
Revision Passes
Pass 1: Developmental Edit (Big Picture)
- Does the story arc work?
- Are character motivations clear and consistent?
- Is the pacing right? (Too slow? Too rushed?)
- Do the stakes escalate properly?
- Are subplots resolved?
- Is the theme woven through the narrative?
- Are there plot holes or contradictions?
Pass 2: Scene-Level Edit
- Does every scene have a purpose (advance plot, reveal character, raise stakes)?
- Are scene openings strong?
- Do scene endings create momentum?
- Is the POV consistent within each scene?
- Is there enough conflict in each scene?
Pass 3: Line Edit (Craft)
- Sentence variety and rhythm
- Word choice precision
- Showing vs telling
- Dialogue naturalism
- Sensory details
- Filter word removal
- Passive voice reduction
- Adverb pruning
Pass 4: Copy Edit (Correctness)
- Grammar and punctuation
- Spelling
- Consistency (names, places, timeline)
- Formatting
- Style guide compliance
Feedback Format
For each issue found:
📍 Location: [Chapter/Page/Paragraph]
🔍 Issue: [What's wrong]
💡 Why: [Why it matters for the reader]
✏️ Suggestion: [How to fix it — never rewrite without permission]Rules
- Always ask which pass the author wants
- Never rewrite without explicit permission
- Celebrate what's working, not just what needs fixing
- Be specific — "this doesn't work" is useless; "the tension drops here because we already know the answer" is actionable
© Ckokoski, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/author/revise of Ckokoski/AuthorAgent.
Open the folder on GitHubat commit 47e9570
Compare with similar skills
Revise 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Revise this skillCkokoski/AuthorAgent | 124 | — | ~473 | Automated safety check: Pass | MIT | |
| User-Facing Text Cleanupguillaumemeyer/watermarks-remover | 24k | — | ~3.5k | Automated safety check: Pass | MIT | |
| Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode | 7.4k | 3 repos | ~3k | Automated safety check: Pass | MIT | |
| Chinese Text Humanizerop7418/Humanizer-zh | 19k | — | ~2k | Automated safety check: Pass | MIT | |
| Baoyu TranslateJimLiu/baoyu-skills | 27k | 1 repos | ~3.9k | Automated safety check: Pass | MIT | |
| Natural Japanese Business Writingcoji/natural-japanese | 1.9k | — | ~2.1k | Automated safety check: Pass | MIT |
Similar skills
Story Multi-Perspective Review
zenstory-ai/oh-story-claudecode
Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.
Chinese Text Humanizer
op7418/Humanizer-zh
Edits Chinese articles, comments and documents to remove filler, repetition and template phrasing while keeping the facts, the level of certainty and the author's voice.
Baoyu Translate
JimLiu/baoyu-skills
Translates articles and files in quick, normal or refined mode, with a custom glossary, saved preferences and a review-and-polish workflow for publication quality.
Natural Japanese Business Writing
coji/natural-japanese
Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.
Defensive Writing Editor
lennney/stop-that-shit
Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.
More from Ckokoski/AuthorAgent
All 23 skills in this repoAfter Action Review
Ckokoski/AuthorAgent
Structured post-goal reflection that extracts lessons, evaluates quality, and feeds the self-improvement loop
Comp Title Finder
Ckokoski/AuthorAgent
Find and analyze comparable titles for query letters, marketing, and positioning strategy
Continuity Check
Ckokoski/AuthorAgent
Scan manuscript for inconsistencies in characters, timeline, settings, and names
Deep Voice Analysis
Ckokoski/AuthorAgent
Advanced 47-marker voice analysis engine — analyzes your writing to build a comprehensive Voice Profile for AuthorClaw
Dictation Cleanup
Ckokoski/AuthorAgent
Transform raw speech-to-text dictation into polished prose while preserving the author's natural voice
Error Recovery
Ckokoski/AuthorAgent
Intelligent error diagnosis, automatic recovery strategies, and prevention of recurring failures
Related
Categories
Questions about Revise
What does Revise do?
Multi-pass revision - developmental editing, line editing, copy editing. Revise is an agent skill from Ckokoski/AuthorAgent.
When should I use Revise?
Revise fits situations like: tasks that involve Copy editing and proofreading.
How do I install Revise in Claude Code?
Run `npx skills add Ckokoski/AuthorAgent --skill revise -a claude-code`. Or copy the skill folder (skills/author/revise in Ckokoski/AuthorAgent) into .claude/skills/revise in your project. Claude Code loads it when a task matches its description.
How do I install Revise in Codex?
Run `npx skills add Ckokoski/AuthorAgent --skill revise -a codex`. Or copy the skill folder (skills/author/revise in Ckokoski/AuthorAgent) into .agents/skills/revise in your project. Codex loads it when a task matches its description.
Can I use Revise 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 Ckokoski/AuthorAgent --skill revise -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/revise, .gemini/skills/revise, .github/skills/revise and .opencode/skills/revise in your project.
What does Revise need to run?
SKILL.md names no scripts, command-line tools or credentials: Revise is instructions for the agent only.
Does Revise 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 Revise safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Revise use?
Revise 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 Revise use?
About 473 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Revise?
Skills that share tags, products or a category with Revise: User-Facing Text Cleanup (guillaumemeyer/watermarks-remover, 24k stars), Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Chinese Text Humanizer (op7418/Humanizer-zh, 19k stars) and Baoyu Translate (JimLiu/baoyu-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Revise?
Ckokoski (a GitHub user) maintains it in Ckokoski/AuthorAgent, which has 124 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on July 11, 2026.
Source: Ckokoski/AuthorAgent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.