About

Imported from nickcrew/claude-cortex (skills/ai-tells-scan/SKILL.md). Install upstream with npx skills add nickcrew/claude-cortex --skill ai-tells-scan. Copyright stays with the author.

AI Tells — Surface Scan

Name: ai-tells-scan
Author: nickcrew

A near-mechanical pass that strips the obvious AI fingerprints from prose. Runs before any prose artifact is presented as final.

When This Runs

Auto-engages whenever the task produces prose-as-artifact:

READMEs, CONTRIBUTING, CHANGELOG
Technical documentation under docs/
PR descriptions, PR comments, commit message bodies
Tutorials, guides, blog posts, release notes
Any markdown intended for human readers

Skip for: code comments (different rules), inline chat replies, structured data (YAML/JSON), or anything pure-config.

How To Use

After drafting prose, scan it once against each list below. Every match is a rewrite, not a debate. The lists are deliberately short and high-leverage — if a tell isn't here, it belongs in ai-tells-review.

Banned Punctuation

Em dashes connecting clauses. Replace with period, comma, colon, or parentheses depending on the relationship. The em dash is the single most diagnostic AI tell in prose.
Smart quotes when the source is plain ASCII. Mixing curly and straight quotes in a doc is a copy-paste fingerprint.
Ellipses for dramatic pause in technical writing (it's...complicated). Reads as performance.

Banned Sentence Openers

"Importantly," "Notably," "Crucially," "Interestingly"
"Furthermore," "Moreover," "Additionally"
"It's worth noting that…" / "It bears mentioning…"
"In essence," "Ultimately," "At its core"
"In conclusion," "To summarize," "In summary"
"Great question!" or any sycophantic acknowledgement

If the sentence after the opener stands on its own, delete the opener. It almost always does.

Banned Vocabulary

These words appear far more often in machine-generated prose than human prose. Each has a fix-direction.

Word / Phrase	Why it's a tell	Fix direction
`delve`	Diagnostic on its own	use `look at`, `examine`, or just delete
`leverage` (verb)	Corporate-AI fingerprint	use `use`
`robust`, `comprehensive`, `seamless`, `streamlined`	Empty positive adjectives	name the specific property
`cutting-edge`, `innovative`, `state-of-the-art`	Marketing puff	describe what it actually does
`elegantly`, `seamlessly`, `gracefully`	Empty positive adverbs	delete the adverb
`modulo` (in non-math prose)	Claude tic	use `except for` or `aside from`
`stakeholders`	Generic abstraction	name the people or roles
`passionate about`, `excited to`, `thrilled to`	Performative enthusiasm	state what was done
`it's worth noting`	Throat-clearing	delete; state the thing
`at the end of the day`	Verbal filler	delete
`move the needle`, `circle back`, `align on`	Corporate cliche	name the actual action

Banned Structural Reflexes (Surface Layer)

These are mechanical enough to catch on a scan; deeper rhythm/structure tells live in ai-tells-review.

Tricolon reflex. Three-item lists by default ("fast, reliable, and scalable"). If two items would do, use two. If five, use five.
"This is not X — it's Y" contrastive bold. The mirrored "Why not pure JSON: / Why not pure scriptblocks:" pattern. Delete the contrast or merge into a single sentence.
Decision-stamp formality. **Decided 2026-05-18:** style headers in personal notes. Real humans rarely formalize their own decisions like a court ruling.
Self-narration. Sentences that comment on what the doc is doing: "That's the dashboard's reason for existing." / "(this is where we start)". Delete and let the doc do the thing instead of describing itself.
Compliment sandwich. Soften → criticize → soften. State the criticism directly.
Three consecutive sentences saying the same thing in different words. Delete two of them.

Banned Visual Reflexes

ASCII art boxes for layered diagrams. When the diagram is more than two boxes, use mermaid or just describe the layers in prose.
Italicized rhetorical emphasis. missing, separately, on this dashboard. Italics are for terms-of-art and titles, not tone. One per long doc, max.
Bold for emphasis on every paragraph. Bold should mark scannable structure (headers, key terms), not feeling.

Coined-Phrase Tic Check

Before submitting, scan for any minted phrase repeated 3+ times across the doc. Examples seen in real artifacts: "proves the framework," "earns its place," "5-second glance." Humans usually rephrase the second or third use; models don't. Rephrase all but the first occurrence.

What This Skill Does Not Do

Catch rhythm patterns (uniform sentence length, paragraph-level parallelism, gerund cascade)
Catch hedging cadence and manufactured both-sidesing
Catch aphoristic closers and summary-of-summary endings
Replace voice skills like nick-voice — this subtracts machine fingerprints, it doesn't add personality

For all of the above, use ai-tells-review.

Output Shape

The scan is invisible by default — it runs before the prose is presented and the prose comes out clean. If a tell can't be cleanly fixed (e.g. the contrastive-bold pattern is load-bearing for the argument), flag it inline:

NOTE: kept "X — Y" construction at line 42; the contrast carries the argument and rewriting flattens it.

This gives the user one place to check whether to push back on a specific judgment.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/nickcrew-claude-cortex-ai-tells-scan/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

nickcrew-claude-cortex-ai-tells-scan.ocm.jsonjson

{
  "ocm": "1",
  "id": "nickcrew-claude-cortex-ai-tells-scan",
  "kind": "skill",
  "name": "ai-tells-scan",
  "description": "Use when writing tasks produce prose artifacts (READMEs, docs, PR text, tutorials, guides, posts, release notes) and need a fast surface scan for AI tells. Auto-engages on prose writing tasks; checks banned punctuation, stock vocabulary, and mechanical patterns. For the structural judgment pass on rhythm and rhetorical reflexes, use ai-tells-review. Not a replacement for voice skills like nick-voice; this removes machine fingerprints, it does not add a target voice.",
  "publisher": "nickcrew",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "finance"
    ],
    "tags": [
      "skill-md",
      "writing",
      "editing",
      "prose",
      "documentation",
      "ai-tells",
      "ai-fingerprints",
      "generated-prose",
      "prose-scan",
      "banned-vocabulary"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when writing tasks produce prose artifacts (READMEs, docs, PR text, tutorials, guides, posts, release notes) and need a fast surface scan for AI tells. Auto-engages on prose writing tasks; checks banned punctuation, stock vocabulary, and mechanical patterns. For the structural judgment pass on rhythm and rhetorical reflexes, use ai-tells-review. Not a replacement for voice skills like nick-voice; this removes machine fingerprints, it does not add a target voice."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/nickcrew/claude-cortex",
      "path": "skills/ai-tells-scan/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/nickcrew/claude-cortex/blob/HEAD/skills/ai-tells-scan/SKILL.md",
      "key": "nickcrew/claude-cortex/skills/ai-tells-scan/SKILL.md"
    }
  },
  "instructions": "# AI Tells — Surface Scan\n\nA near-mechanical pass that strips the obvious AI fingerprints from prose. Runs before any prose artifact is presented as final.\n\n## When This Runs\n\nAuto-engages whenever the task produces prose-as-artifact:\n\n- READMEs, CONTRIBUTING, CHANGELOG\n- Technical documentation under `docs/`\n- PR descriptions, PR comments, commit message bodies\n- Tutorials, guides, blog posts, release notes\n- Any markdown intended for human readers\n\nSkip for: code comments (different rules), inline chat replies, structured data (YAML/JSON), or anything pure-config.\n\n## How To Use\n\nAfter draft",
  "cost": {
    "context_tokens": 1337
  }
}

Fetch it by URL: GET /api/v1/registry/nickcrew-claude-cortex-ai-tells-scan/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.