\r \r

Humanize AI Text\r

\r Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written.\r \r Based on Wikipedia's comprehensive "Signs of AI writing" guide.\r \r

Features\r

\r

• AI Detection: Identifies 16 pattern categories of AI-generated text\r
• Pattern Categories:\r
  • Citation bugs\r
  • Knowledge-cutoff phrases\r
  • Chatbot artifacts\r
  • Markdown/code remnants\r
  • AI-specific vocabulary\r
  • Filler phrases\r
  • Punctuation quirks\r
  • Stylistic parallelisms\r
  • Inflated symbolism\r
  • Promotional language\r
  • Superficial -ing analyses\r
  • Vague attributions\r
  • Em dash overuse\r
  • Rule of three\r
  • Negative parallelisms\r
  • Excessive conjunctive phrases\r \r
• Diagnostic Reports: Generate detailed AI detection reports\r
• Text Transformation: Rewrite text to sound more human\r
• Comparison Mode: Compare original vs humanized versions\r \r

Usage\r

\r

Detect AI Writing\r

\r

# Basic detection\r
python skills/humanize-ai-text/scripts/detect.py text.txt\r
\r
# JSON output\r
python skills/humanize-ai-text/scripts/detect.py text.txt -j\r
\r
# Score only\r
python skills/humanize-ai-text/scripts/detect.py text.txt -s\r
\r
# Pipe text directly\r
echo "This text might be AI-generated" | python skills/humanize-ai-text/scripts/detect.py\r
```\r
\r
### Transform Text\r
\r
```bash\r
# Basic transformation\r
python skills/humanize-ai-text/scripts/transform.py text.txt\r
\r
# Output to file\r
python skills/humanize-ai-text/scripts/transform.py text.txt -o clean.txt\r
\r
# Aggressive mode (more changes)\r
python skills/humanize-ai-text/scripts/transform.py text.txt -a\r
\r
# Quiet mode (no progress output)\r
python skills/humanize-ai-text/scripts/transform.py text.txt -q\r
```\r
\r
### Compare Versions\r
\r
```bash\r
# Compare original and transformed\r
python skills/humanize-ai-text/scripts/compare.py text.txt\r
\r
# Compare and save result\r
python skills/humanize-ai-text/scripts/compare.py text.txt -o document_v2.txt\r
```\r
\r
## Installation\r
\r
The skill is already installed. To use it, ensure you have Python 3 installed.\r
\r
### Dependencies\r
\r
No external dependencies required - uses Python standard library.\r
\r
## Pattern Detection\r
\r
The detection script identifies these AI writing patterns:\r
\r
### 1. Citation Bugs\r
- Fake or unverifiable sources\r
- "According to experts" without specifics\r
- Generic study references\r
\r
### 2. Knowledge Cutoff\r
- "As of my last update"\r
- "I don't have real-time information"\r
- Date-stamped limitations\r
\r
### 3. Chatbot Artifacts\r
- "I'd be happy to help"\r
- "Great question!"\r
- "Let me break this down"\r
- Excessive hedging\r
\r
### 4. AI Vocabulary\r
- "delve into"\r
- "testament to"\r
- "in conclusion"\r
- "it's worth noting"\r
- "important to understand"\r
\r
### 5. Filler Phrases\r
- Unnecessary introductions\r
- Redundant summaries\r
- Padding content\r
\r
### 6. Stylistic Issues\r
- Rule of three overuse\r
- Negative parallelisms\r
- Em dash overuse\r
- Excessive conjunctive phrases\r
\r
## Best Practices\r
\r
1. **Detect First**: Run detection before transformation\r
2. **Review Changes**: Always review transformed text\r
3. **Use Compare**: Compare versions to understand changes\r
4. **Iterate**: May need multiple passes for best results\r
5. **Custom Patterns**: Edit `patterns.json` to add custom detections\r
\r
## Customization\r
\r
### Add Custom Patterns\r
\r
Edit `skills/humanize-ai-text/scripts/patterns.json`:\r
\r
```json\r
{\r
  "custom_patterns": {\r
    "my_pattern": {\r
      "regex": "pattern_here",\r
      "replacement": "replacement_text",\r
      "description": "What this pattern detects"\r
    }\r
  }\r
}\r
```\r
\r
### Batch Processing\r
\r
Process multiple files:\r
\r
```bash\r
for f in *.md; do\r
  python skills/humanize-ai-text/scripts/detect.py "$f" -s\r
  python skills/humanize-ai-text/scripts/transform.py "$f" -a -o "${f%.md}_clean.md" -q\r
done\r
```\r
\r
## Output Formats\r
\r
### Detection Output\r
\r
```\r
AI Detection Report\r
===================\r
File: text.txt\r
AI Probability: 73%\r
\r
Patterns Detected:\r
- AI Vocabulary: 12 instances\r
- Filler Phrases: 8 instances\r
- Stylistic Parallelisms: 5 instances\r
...\r
```\r
\r
### Transformation Output\r
\r
```\r
Original: "I'd be happy to delve into this important topic."\r
Humanized: "Let's explore this topic."\r
```\r
\r
## Security Notes\r
\r
- ✅ No external network calls\r
- ✅ All processing done locally\r
- ✅ No credential access\r
- ✅ Safe file operations only\r
- ✅ No data exfiltration\r
\r
## Integration\r
\r
### With Writing Workflow\r
\r
1. Write draft (AI-assisted or not)\r
2. Run detection to check AI score\r
3. Transform if score is high\r
4. Compare versions\r
5. Manual review and final edits\r
\r
### With Content Pipeline\r
\r
```bash\r
# In CI/CD or pre-commit hook\r
python skills/humanize-ai-text/scripts/detect.py content.md -s\r
# Fail if AI score > threshold\r
```\r
\r
## Troubleshooting\r
\r
### False Positives\r
\r
Some legitimate writing may trigger patterns. Review manually.\r
\r
### False Negatives\r
\r
AI models evolve. Update patterns.json regularly.\r
\r
### Encoding Issues\r
\r
Ensure files are UTF-8 encoded:\r
```bash\r
python skills/humanize-ai-text/scripts/detect.py file.txt --encoding utf-8\r
```\r
\r
## Examples\r
\r
### Example 1: Blog Post\r
\r
```bash\r
# Check AI score\r
python skills/humanize-ai-text/scripts/detect.py blog_post.md -s\r
# Output: AI Probability: 68%\r
\r
# Transform\r
python skills/humanize-ai-text/scripts/transform.py blog_post.md -o blog_post_clean.md -a\r
\r
# Compare\r
python skills/humanize-ai-text/scripts/compare.py blog_post.md -o blog_post_clean.md\r
```\r
\r
### Example 2: Email\r
\r
```bash\r
echo "I hope this email finds you well. I wanted to reach out regarding..." | \\r
  python skills/humanize-ai-text/scripts/detect.py\r
```\r
\r
### Example 3: Academic Writing\r
\r
```bash\r
# Detect AI patterns in paper\r
python skills/humanize-ai-text/scripts/detect.py paper.md -j > report.json\r
\r
# Transform with conservative settings\r
python skills/humanize-ai-text/scripts/transform.py paper.md -o paper_clean.md\r
```\r
\r
## Resources\r
\r
- Wikipedia: "Signs of AI writing"\r
- Original research on AI text detection\r
- Community pattern contributions\r
\r
---\r
\r
*For more info, visit: https://clawhub.ai/biostartechnology/humanizer*\r