detect-ai-text – Documents & Office skill for AI agents

AI-Text Detection

Inspect a provider’s uncalibrated AI-style signal for a document’s prose, with the specific linguistic tells and an honest abstention when the document isn't prose. Uses an external Stipple API; verify current access, cost and privacy terms.

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.

   curl --fail --show-error --silent --max-time 30 -X POST https://www.stipple.sh/v1/detect-ai-text \
     -F "[email protected]" \
     -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

Provider AI-style score: 0.87 (uncalibrated; lean: ai; not authorship proof)
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
• Verify current authentication/allowance on https://www.stipple.sh; do not guarantee a free anonymous tier or publish the submitted document.