detect-ai

SKILL.md

Detect AI Content

Analyze text to determine if it was written by AI using the HumanizerAI API.

How It Works

When the user invokes /detect-ai, you should:

Extract the text from $ARGUMENTS

Call the HumanizerAI API to analyze the text

Present the results in a clear, actionable format

API Call

Make a POST request to https://humanizerai.com/api/v1/detect:

Authorization: Bearer $HUMANIZERAI_API_KEY
Content-Type: application/json

{
"text": "<user's text>"
}

## API Response Format

The API returns JSON like this:

```json
{
  "score": {
    "overall": 82,
    "perplexity": 96,
    "burstiness": 15,
    "readability": 23,
    "satPercent": 3,
    "simplicity": 35,
    "ngramScore": 8,
    "averageSentenceLength": 21
  },
  "wordCount": 82,
  "sentenceCount": 4,
  "verdict": "ai"
}

IMPORTANT: The main AI score is score.overall (not score directly). This is the score to display to the user.

Present Results Like This

## AI Detection Results

**Score:** [score.overall]/100 ([verdict])
**Words Analyzed:** [wordCount]

### Metrics
- Perplexity: [score.perplexity]
- Burstiness: [score.burstiness]
- Readability: [score.readability]
- N-gram Score: [score.ngramScore]

### Recommendation
[Based on score.overall, suggest whether to humanize]

Score Interpretation (use score.overall)

0-20: Human-written content

21-40: Likely human, minor AI patterns

41-60: Mixed signals, could be either

61-80: Likely AI-generated

81-100: Highly likely AI-generated

Error Handling

If the API call fails:

Check if HUMANIZERAI_API_KEY is set

Suggest the user get an API key at https://humanizerai.com

Provide the error message for debugging