aitells-action

GitHub Action that scans PR titles, bodies, and commit messages for AI text fingerprints (em-dashes, "delve", parallel bullets, "in conclusion", and 9 more). Posts a friendly summary comment on every PR.

Why use this

If your team uses Claude / ChatGPT to draft PR descriptions and commit messages, this catches the patterns AI loves and humans rarely write. Keep your repo history sounding human.

Quick start

# .github/workflows/aitells-scan.yml
name: aitells AI fingerprint scan

on:
  pull_request:
    types: [opened, edited, synchronize]

jobs:
  scan:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: Perufitlife/aitells-action@v1
        with:
          target: both        # pr_body | commits | both | <literal string>
          fail-on: 0          # 0 = never fail; 65 = fail if humanness < 65
          comment: true       # post a PR comment with the result

Example PR comment

🟡 aitells score: 72/100 (mostly human) · 5 flags (1 high)

• em-dash [high] · 1 hit(s)
• buzzword-cluster [medium] · 2 hit(s)
• however-comma [low] · 1 hit(s)
• navigate-the [medium] · 1 hit(s)

aitells scans PR text for the 12 AI fingerprints Reddit mods, Turnitin, and AI detectors all flag.

Inputs

name	required	default	description
target	no	both	What to scan: pr_body, commits, both, or any literal string
fail-on	no	0	Score threshold to fail (0-100). 0 = never fail
comment	no	true	Post a PR comment with the result
github-token	no	${{ github.token }}	Token for posting the PR comment

Outputs

• score — humanness 0-100
• grade — human / mostly human / smells like AI / AI
• flags — total flag count

Use it as a quality gate

- uses: Perufitlife/aitells-action@v1
  with:
    fail-on: 65    # block PR merge if humanness < 65

The 12 rules

em-dash · "delve" · "tapestry/realm/landscape" · "navigate the X" · "Great question" openers · "In conclusion" closers · buzzword cluster (leverage/robust/seamless) · parallel bullets · tricolon rhythm · uniform sentence length · Title Case headings · "However,/Moreover,/Furthermore,"

Full rule reference →

Pricing

• This Action: free forever (it calls the free aitells detector API)
• Pair it with aitells.vercel.app/rewrite for $19 lifetime humanizer access

License

MIT.