do-review-ai-writing

Detect AI-generated writing patterns in docs, docstrings, commit messages, and PR descriptions.

2|Updated May 25, 2026
One-click install
npx skills add https://github.com/edheltzel/Do-Skills --skill do-review-ai-writing-edheltzel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: do-review-ai-writing
Source: https://github.com/edheltzel/Do-Skills/tree/main/skills/slop-guard/do-review-ai-writing
Command: npx skills add https://github.com/edheltzel/Do-Skills --skill do-review-ai-writing-edheltzel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-generated text leaks into developer artifacts—docs, docstrings, commit messages, and PR descriptions—bringing promotional language, chat leaks, tautological docstrings, and filler that erode trust and clarity. This Skill scans those artifacts and reports each pattern with a concrete fix suggestion. ## Core Features & Use Cases - Six pattern categories: Detects content, vocabulary, formatting, communication, filler, and code-docs issues using a detailed reference catalog with false-positive rules. - Scoped scanning: Reviews changed files from main by default, or the full codebase with --all, partitioned into Prose, Code Docs, and Git artifact groups. - Structured reporting: Writes a validated ai-writing-review.json report with risk and fix-safety ratings, plus a human-readable summary grouped by category. - Use Case: Before merging a PR, run the review to catch commit messages starting with "Certainly!" or docstrings that merely restate function names, then hand findings to a humanize pass. ## Quick Start Ask the agent to review the current branch's changed files for AI-generated writing patterns and produce a findings report.

Frequently Asked Questions about do-review-ai-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect AI-generated writing in my codebase?▼

Run the review against changed files from main or use the --all flag for a full scan. It checks six pattern categories—content, vocabulary, formatting, communication, filler, and code docs—and writes findings to ai-writing-review.json with fix suggestions.

What AI writing patterns does this review flag?▼

It flags high-signal vocabulary like delve and leverage, chat leaks such as "Certainly!", tautological docstrings, promotional language, excessive hedging, boldface overuse, and generic conclusions. Each category has a dedicated reference file with examples.

Can I scan only commit messages and PR descriptions?▼

Yes. Git artifacts are a dedicated scan group covering commit messages from the branch and PR bodies via gh pr view. Findings use synthetic paths like git:commit:<sha> so they can be reported without a file line number.

Does the AI writing review produce false positives?▼

The skill includes explicit false-positive rules, such as allowing "ensure" in security docs and formal tone in API references. A verification protocol requires reading surrounding context before reporting any finding.

What output format does the writing review generate?▼

It writes ai-writing-review.json containing findings with category, type, file, line, original text, suggestion, risk, and fix-safety fields, plus a summary grouped by category. JSON validity is verified before the summary displays.