humanize
npx machina-cli add skill humanizerai/agent-skills/humanize --openclawHumanize AI Text
Transform AI-generated content into natural, human-like writing using the HumanizerAI API.
How It Works
When the user invokes /humanize, you should:
- Parse $ARGUMENTS for text and optional --intensity flag
- Call the HumanizerAI API to humanize the text
- Present the humanized text with before/after scores
- Show remaining credits
Parsing Arguments
The user may provide:
- Just text:
/humanize [their text] - With intensity:
/humanize --intensity aggressive [their text]
Default intensity is medium.
Intensity Levels
| Value | Name | Description | Best For |
|---|---|---|---|
light | Light | Subtle changes, preserves style | Already-edited text, low AI scores |
medium | Medium | Balanced rewrites (default) | Most use cases |
aggressive | Bypass | Maximum bypass mode | High AI scores, strict detectors |
API Call
Make a POST request to https://humanizerai.com/api/v1/humanize:
Authorization: Bearer $HUMANIZERAI_API_KEY
Content-Type: application/json
{
"text": "<user's text>",
"intensity": "medium"
}
Response Format
Present results like this:
## Humanization Complete
**Score:** X → Y (improvement)
**Words Processed:** N
**Credits Remaining:** X
---
### Humanized Text
[The humanized text]
---
[Recommendation based on final score]
Credit Usage
- 1 word = 1 credit
- Detection is free
- Check credits at https://humanizerai.com/dashboard
Error Handling
Insufficient Credits
If the user doesn't have enough credits:
- Show how many credits are needed vs available
- Direct them to https://humanizerai.com/dashboard to top up
Invalid API Key
- Check HUMANIZERAI_API_KEY environment variable
- Direct to https://humanizerai.com to get a key
Rate Limit
If rate limited, suggest waiting or upgrading to Business plan.
Source
git clone https://github.com/humanizerai/agent-skills/blob/main/skills/humanize/SKILL.mdView on GitHub Overview
Transforms AI-generated content into more natural, human-like writing using the HumanizerAI API. It reports before/after scores and shows remaining credits to help manage usage, making AI-assisted content feel more authentic while monitoring costs.
How This Skill Works
You invoke /humanize with text and an optional intensity (default is medium). The system sends a POST to https://humanizerai.com/api/v1/humanize with the text and chosen intensity, then presents the humanized text along with before/after scores and the remaining credits.
When to Use It
- You have AI-generated drafts that need to read as more natural and human-like
- You want to tailor tone or style to a specific audience or brand voice
- You are managing content within word-count-based credits and need visibility into usage
- You’re polishing customer-facing content (emails, product descriptions) for a more human tone
- You’re revising long-form content to reduce obvious AI writing patterns
Quick Start
- Step 1: Run /humanize with your text, e.g., /humanize [your text] or /humanize --intensity aggressive [your text]
- Step 2: Review the returned before/after scores and the Credits Remaining
- Step 3: Use the humanized text in your content and monitor credits
Best Practices
- Start with medium intensity to balance readability and style preservation
- Always review for factual accuracy and brand consistency after rewriting
- Monitor credits remaining and plan rewrites accordingly
- Disclose AI-assisted writing when required by policy or audience expectations
- Test with short samples before applying to large texts
Example Use Cases
- Polishing product descriptions to sound more natural and engaging
- Rewriting blog intros to improve reader connection
- Softening canned responses for customer support
- Localizing content to align with regional audience tone
- Revamping outreach emails to sound more human and personable
