Skip to content

Commit 500de89

Browse files
charlesjones-devcharlesjones-dev
committed
feat(ai-writing): Add writing humanizer plugin with interactive workflow
Rewrites SKILL.md from scratch following marketplace skill conventions: interactive AskUserQuestion flow, content-type rules, 6 grouped pattern categories (down from 24 individual), developer-specific patterns, and intensity levels. Registers plugin in marketplace and updates docs.
1 parent 9373422 commit 500de89

7 files changed

Lines changed: 418 additions & 0 deletions

File tree

‎.claude-plugin/marketplace.json‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,28 @@
172172
},
173173
"repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev"
174174
},
175+
{
176+
"name": "ai-writing",
177+
"source": "./plugins/ai-writing",
178+
"description": "AI-powered writing quality tools - Detect and remove AI writing patterns to make text sound natural and human-written",
179+
"version": "1.0.0",
180+
"keywords": [
181+
"ai",
182+
"writing",
183+
"humanizer",
184+
"editing",
185+
"content",
186+
"quality",
187+
"natural-language",
188+
"ai-detection",
189+
"skills"
190+
],
191+
"author": {
192+
"name": "Charles Jones",
193+
"url": "https://charlesjones.dev"
194+
},
195+
"repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev"
196+
},
175197
{
176198
"name": "ai-learn",
177199
"source": "./plugins/ai-learn",

‎CHANGELOG.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1111

1212
### Added
1313

14+
#### AI-Writing Plugin (v1.0.0)
15+
16+
- **New plugin for writing quality tools**
17+
- Detect and remove signs of AI-generated writing from text
18+
- Based on Wikipedia's "Signs of AI writing" guide maintained by WikiProject AI Cleanup
19+
20+
- `/writing-humanize` skill for removing AI writing patterns
21+
- Identifies 24 documented AI writing patterns across 6 categories: content, language/grammar, style, communication, filler/hedging, and personality
22+
- Rewrites problematic sections with natural alternatives while preserving meaning
23+
- Detects inflated significance, promotional language, superficial -ing analyses, vague attributions, overused AI vocabulary, em dash overuse, rule of three, negative parallelisms, sycophantic tone, and more
24+
- Includes full before/after examples for each pattern category
25+
1426
#### AI-Workflow Plugin (v1.3.0)
1527

1628
- **Added `/workflow-ship` skill for end-to-end shipping workflow**

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ This Claude Code plugin marketplace provides plugins that extend Claude Code's c
2626
| [ai-security](plugins/ai-security/) | AI-powered security auditing with reproducible reports | `/security-init`, `/security-audit`, `/security-scan-dependencies` | `security-auditor`, `security-dependency-scanner` |
2727
| [ai-statusline](plugins/ai-statusline/) | AI-powered status line customization with progress bars | `/statusline-wizard`, `/statusline-edit` | - |
2828
| [ai-workflow](plugins/ai-workflow/) | AI-powered development workflow automation | `/workflow-plan-phases`, `/workflow-implement-phases`, `/workflow-preflight`, `/workflow-ship` | - |
29+
| [ai-writing](plugins/ai-writing/) | AI-powered writing quality tools for natural-sounding text | `/writing-humanize` | - |
2930

3031
> **📝 Note on Audit Plugins:** The `ai-accessibility`, `ai-security`, and `ai-performance` plugins are developer-focused analysis tools designed to identify issues during development. They perform static code analysis, with `ai-accessibility` and `ai-security` also offering URL scanning capabilities (`/accessibility-audit` with Playwright MCP and `/security-scan-dependencies` respectively). These plugins are meant to **complement** (not replace) runtime testing tools, professional services, and manual testing. Use these plugins to catch issues early in the development phase, then validate with specialized testing tools and services appropriate to your domain.
3132

‎plugins/ai-writing/.claude-plugin/plugin.json‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
{
2+
"name": "ai-writing",
3+
"version": "1.0.0",
4+
"description": "AI-powered writing quality tools - Detect and remove AI writing patterns to make text sound natural and human-written",
5+
"author": {
6+
"name": "Charles Jones",
7+
"url": "https://charlesjones.dev"
8+
},
9+
"repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev",
10+
"license": "MIT",
11+
"keywords": [
12+
"ai",
13+
"writing",
14+
"humanizer",
15+
"editing",
16+
"content",
17+
"quality",
18+
"natural-language",
19+
"ai-detection",
20+
"skills"
21+
]
22+
}

‎plugins/ai-writing/LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Charles Jones
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎plugins/ai-writing/README.md‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# AI-Writing Plugin
2+
3+
**Writing quality tools for Claude Code.** Detect and remove signs of AI-generated text to make writing sound natural and human-written.
4+
5+
---
6+
7+
## What This Plugin Does
8+
9+
Provides tools for improving writing quality, starting with the humanizer skill that identifies and removes common AI writing patterns. Based on Wikipedia's "Signs of AI writing" guide maintained by WikiProject AI Cleanup.
10+
11+
## Available Skills
12+
13+
### `/writing-humanize`
14+
15+
Remove AI writing patterns from text to make it sound natural and human-written.
16+
17+
**What it does:**
18+
19+
- Scans text for 24 documented AI writing patterns
20+
- Rewrites problematic sections with natural alternatives
21+
- Preserves meaning while improving voice and personality
22+
- Handles content patterns, language/grammar patterns, style patterns, communication patterns, and filler/hedging
23+
24+
**Patterns detected:**
25+
26+
- Inflated significance ("pivotal moment", "stands as a testament")
27+
- Promotional language ("vibrant", "nestled", "breathtaking")
28+
- Superficial -ing analyses ("highlighting", "underscoring", "reflecting")
29+
- Vague attributions ("experts argue", "industry reports")
30+
- Overused AI vocabulary ("delve", "landscape", "tapestry", "crucial")
31+
- Em dash overuse, rule of three, negative parallelisms
32+
- Sycophantic tone, filler phrases, excessive hedging
33+
- Generic positive conclusions, chatbot artifacts
34+
35+
**Usage:**
36+
37+
```
38+
/writing-humanize
39+
# Then provide the text you want to humanize
40+
41+
# Works with:
42+
# - README files and documentation
43+
# - Blog posts and articles
44+
# - Commit messages and PR descriptions
45+
# - Any text that sounds too "AI-generated"
46+
```
47+
48+
---
49+
50+
## Quick Start
51+
52+
### Installation
53+
54+
```
55+
/plugin install ai-writing@claude-code-plugins-dev
56+
```
57+
58+
### Usage
59+
60+
```
61+
# Humanize a piece of text
62+
/writing-humanize
63+
64+
# Provide your text and Claude will:
65+
# 1. Identify AI patterns
66+
# 2. Rewrite problematic sections
67+
# 3. Preserve meaning and add personality
68+
# 4. Present the humanized version with a summary of changes
69+
```
70+
71+
---
72+
73+
## Plugin Details
74+
75+
- **Name:** AI-Writing Plugin
76+
- **Type:** AI Instruction Plugin (Skills)
77+
- **Skill:** `/writing-humanize`
78+
- **Version:** 1.0.0
79+
- **License:** MIT
80+
- **Author:** Charles Jones
81+
82+
---
83+
84+
## Contributing
85+
86+
Found a bug or have a suggestion? [Open an issue](https://github.com/charlesjones-dev/claude-code-plugins-dev/issues) or submit a pull request!
87+
88+
---
89+
90+
## License
91+
92+
MIT License - See [LICENSE](LICENSE) file for details.
93+
94+
---
95+
96+
**Built for developers who want their writing to sound like a human wrote it.**

0 commit comments

Comments
 (0)