human-writing — Claude Code skill for editing text
This skill spots formulaic AI-style wording and revises it while keeping the intended meaning. Use it when editing docs, emails, blog posts, or PRDs.
npx skills add Factory-AI/factory-plugins --skill human-writing -a claude-codeWhat human-writing does
human-writing reviews a draft for patterns such as promotional phrasing, repetitive sentence shapes, and overused connective language, then rewrites the affected passages. It can help with Markdown, technical documentation, emails, blog posts, PRDs, and other writing tasks.
Its approach draws on Wikipedia’s guide to signs of AI writing. The skill aims to retain the text’s meaning and fit its intended tone; it edits prose rather than checking factual claims. For Claude Code, install it with npx from Factory-AI/factory-plugins. It is also available for Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
What it helps with
- revise formulaic wording in technical docs
- remove promotional phrasing from an email
- vary repetitive sentences in a blog post
- edit a PRD without changing its meaning
Example prompts for the agent
- Rewrite this Markdown draft to remove formulaic phrasing while keeping its meaning.
- Review this email for AI-style wording and make the phrasing sound more natural.
- Edit this PRD to keep its tone and meaning while varying repetitive sentences.
How to install human-writing
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill human-writing -a claude-code2Manually: put the files in place
~/.claude/skills/human-writing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/human-writing/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill human-writing -a codex2Manually: put the files in place
.agents/skills/human-writing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill human-writing -a cursor2Manually: put the files in place
.cursor/skills/human-writing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Factory-AI/factory-plugins human-writing2Manually: put the files in place
.github/skills/human-writing/SKILL.md1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill human-writing -a gemini-cli2Platform CLI
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/droid-evolved/skills/human-writingManually: put the files in place
.devin/skills/human-writing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill human-writing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about human-writing
How do I install human-writing in Claude Code?
Run npx skills add Factory-AI/factory-plugins --skill human-writing -a claude-code. The skill file is at ~/.claude/skills/human-writing/SKILL.md.
What does human-writing do?
It identifies common machine-written patterns and revises the affected passages while aiming to preserve meaning and tone. It works with editing and drafting tasks.
Which platforms support human-writing?
It is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.