diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..f67a708 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,19 @@ +{ + "name": "humanizer-dev", + "description": "Development marketplace for Humanizer skills library", + "owner": { + "name": "Humanizer Contributors", + "email": "info@humanizer.dev" + }, + "plugins": [ + { + "name": "humanizer", + "description": "Skills library for humanizing code and improving readability", + "version": "2.2.0", + "source": "./", + "author": { + "name": "Humanizer Contributors", + "email": "info@humanizer.dev" + } + } + ] diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..60a0e9e --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "humanizer", + "description": "Skills library for humanizing code and improving readability", + "version": "2.2.0", + "author": { + "name": "Humanizer Contributors", + "email": "info@humanizer.dev" + }, + "homepage": "https://github.com/blader/humanizer", + "repository": "https://github.com/blader/humanizer", + "license": "MIT", + "keywords": ["skills", "humanizer", "readability", "code-quality", "best-practices"] diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json new file mode 100644 index 0000000..4f25924 --- /dev/null +++ b/.cursor-plugin/plugin.json @@ -0,0 +1,17 @@ +{ + "name": "humanizer", + "displayName": "Humanizer", + "description": "Skills library for humanizing code and improving readability", + "version": "2.2.0", + "author": { + "name": "Humanizer Contributors", + "email": "info@humanizer.dev" + }, + "homepage": "https://github.com/blader/humanizer", + "repository": "https://github.com/blader/humanizer", + "license": "MIT", + "keywords": ["skills", "humanizer", "readability", "code-quality", "best-practices"], + "skills": "./skills/", + "agents": "./agents/", + "commands": "./commands/", + "hooks": "./hooks/hooks-cursor.json" diff --git a/README.md b/README.md index 4b64359..8c7cf77 100644 --- a/README.md +++ b/README.md @@ -4,20 +4,29 @@ A Claude Code skill that removes signs of AI-generated writing from text, making ## Installation -### Recommended (clone directly into Claude Code skills directory) +### Claude Plugin Marketplace (Recommended) + +Register the marketplace and install: + +```bash +claude plugin marketplace add https://github.com/blader/humanizer +claude plugin install humanizer-dev:humanizer +``` + +### Manual Install (Git Clone) + +Clone directly into Claude skills directory: ```bash mkdir -p ~/.claude/skills git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer ``` -### Manual install/update (only the skill file) - -If you already have this repo cloned (or you downloaded `SKILL.md`), copy the skill file into Claude Code’s skills directory: +### Cursor ```bash -mkdir -p ~/.claude/skills/humanizer -cp SKILL.md ~/.claude/skills/humanizer/ +mkdir -p ~/.cursor/skills +git clone https://github.com/blader/humanizer.git ~/.cursor/skills/humanizer ``` ## Usage diff --git a/SKILL.md b/skills/humanizer/SKILL.md similarity index 93% rename from SKILL.md rename to skills/humanizer/SKILL.md index 656b2f5..a4146f3 100644 --- a/SKILL.md +++ b/skills/humanizer/SKILL.md @@ -1,13 +1,6 @@ --- name: humanizer -version: 2.2.0 -description: | - Remove signs of AI-generated writing from text. Use when editing or reviewing - text to make it sound more natural and human-written. Based on Wikipedia's - comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: - inflated symbolism, promotional language, superficial -ing analyses, vague - attributions, em dash overuse, rule of three, AI vocabulary words, negative - parallelisms, and excessive conjunctive phrases. +description: "Remove signs of AI-generated writing from text to make it sound more natural and human. Use when editing or reviewing content to eliminate AI patterns: inflated symbolism, promotional language, vague attributions, overused em dashes, AI vocabulary, and excessive hedging. Adds voice and personality to sterile writing." allowed-tools: - Read - Write @@ -19,18 +12,18 @@ allowed-tools: # Humanizer: Remove AI Writing Patterns -You are a writing editor that identifies and removes signs of AI-generated text to make writing sound more natural and human. This guide is based on Wikipedia's "Signs of AI writing" page, maintained by WikiProject AI Cleanup. +You are a writing editor that identifies and removes signs of AI-generated text to make writing sound more natural and human. This skill is based on Wikipedia's "Signs of AI writing" page, maintained by WikiProject AI Cleanup. ## Your Task -When given text to humanize: +When editing text to humanize it: -1. **Identify AI patterns** - Scan for the patterns listed below -2. **Rewrite problematic sections** - Replace AI-isms with natural alternatives -3. **Preserve meaning** - Keep the core message intact -4. **Maintain voice** - Match the intended tone (formal, casual, technical, etc.) -5. **Add soul** - Don't just remove bad patterns; inject actual personality -6. **Do a final anti-AI pass** - Prompt: "What makes the below so obviously AI generated?" Answer briefly with remaining tells, then prompt: "Now make it not obviously AI generated." and revise +1. **Identify AI patterns** — Scan for the patterns listed below +2. **Rewrite sections** — Replace AI-isms with natural alternatives +3. **Preserve meaning** — Keep the core message intact +4. **Maintain voice** — Match the intended tone (formal, casual, technical, etc.) +5. **Add personality** — Don't just remove bad patterns; inject actual human voice +6. **Final audit** — Ask yourself: "What makes this obviously AI generated?" Answer briefly with remaining tells, then revise --- @@ -393,27 +386,27 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as ## Process 1. Read the input text carefully -2. Identify all instances of the patterns above -3. Rewrite each problematic section -4. Ensure the revised text: +2. Identify instances of the patterns listed above +3. Rewrite each problematic section for clarity and naturalness +4. Verify the revised text: - Sounds natural when read aloud - Varies sentence structure naturally - Uses specific details over vague claims - Maintains appropriate tone for context - Uses simple constructions (is/are/has) where appropriate 5. Present a draft humanized version -6. Prompt: "What makes the below so obviously AI generated?" -7. Answer briefly with the remaining tells (if any) -8. Prompt: "Now make it not obviously AI generated." -9. Present the final version (revised after the audit) +6. Self-audit: "What makes this obviously AI generated?" +7. Answer briefly with remaining tells (if any) +8. Revise again if needed +9. Present the final version ## Output Format Provide: 1. Draft rewrite -2. "What makes the below so obviously AI generated?" (brief bullets) +2. Remaining AI tells (brief bullets, if any) 3. Final rewrite -4. A brief summary of changes made (optional, if helpful) +4. Summary of key changes (optional) ---