# Detect AI Text

> Estimate whether a document's prose was written by AI, with the linguistic tells and honest abstention on non-prose. Use when the user asks whether an essay, report, CV, submission, or article was AI-

- Skill: `ranbot-ai/detect-ai-text` (Agent Skill)
- Install (CLI): `npx skillmds add ranbot-ai/detect-ai-text`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ranbot-ai/detect-ai-text/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ranbot-ai (https://skillmd.com/u/ranbot-ai)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/ranbot-ai/detect-ai-text

---



# AI-Text Detection

Estimate the probability that a document's prose was written by AI, with the specific linguistic tells and an honest abstention when the document isn't prose. Uses the Stipple API (free anonymous tier).

## When to use

- Educators screening student submissions
- Publishers and platforms triaging inbound content
- HR reviewing AI-drafted CVs (flag, don't reject)
- Researchers checking source provenance

## Instructions

1. **Get the document.** URL, local file path (PDF, DOCX, TXT, MD), or raw text via `--text`.

2. **Run detection.**

   ```bash
   curl -X POST https://www.stipple.sh/v1/detect-ai-text \
     -F "file=@essay.pdf" \
     -H "Authorization: Bearer $STIPPLE_API_KEY"
   ```

   For raw text: POST JSON `{"text": "..."}` to the same endpoint.

3. **Interpret the response.**

   - `applicable: false` — the document is not prose (forms, tables, scans, spreadsheets). Detection is **deliberately refused** rather than guessed. Report this and stop.
   - `probability` — model confidence (0–1), NOT a calibrated truth
   - `lean` — "ai" | "human" | "unsure"
   - `tells[]` — the specific phrases/patterns flagged (e.g. "It is important to note that", uniform sentence length, low burstiness)
   - `reasoning` — why the model reached its verdict
   - `limitations` — always present; the API states its own noise profile

4. **Report honestly.** This measures *style, not authenticity*:

   | Question | Tool |
   |---|---|
   | Was this *written* by AI? (style) | this skill |
   | Is this document *genuine/tampered*? (forensics) | `verify-document` skill |

   A human can write generically; an AI can write plainly. One triage signal, never a verdict.

## Output format

```
AI-written probability: 0.87  (lean: ai)
prose ratio: 0.82

linguistic tells:
  - "It is important to note that, in today's fast-paced world" (stock phrase)
  - uniform sentence length across paragraphs
  - low burstiness; no authorial asides

reasoning: The text relies entirely on formulaic transition clichés...
limitations: The probability is the model's CONFIDENCE, not a calibrated truth.
```

## Limitations and Safety

- AI-text detection is probabilistic and can disproportionately flag templated,
  coached, translated, accessibility-assisted, or non-native-English writing. Do
  not use it as proof of misconduct or as the sole basis for employment, academic,
  publishing, or disciplinary action.
- Uploading a document sends its contents to a hosted third party. Obtain explicit
  approval first, remove unnecessary personal or confidential material, and verify
  the provider's current retention and deletion terms.
- Preserve the original work and give the affected person a meaningful human review
  and appeal path before any consequential decision.

## Notes

- Non-prose documents (forms, tables, payslips) get `applicable: false` — the engine refuses rather than guessing
- Can false-flag templated/coached or non-native-English writing — always present as one signal alongside human review
- Free anonymous tier works without a key; free key at https://www.stipple.sh