AI Pattern Detection Skill
Purpose
Review phrase patterns and suggest edits that fit the author’s intent and audience. This skill does not detect authorship or certify naturalness.
These are editorial preferences, not evidence of human or AI authorship. Apply only the requirements chosen by the author or project; other phrase and structure suggestions are advisory. Preserve quotations, code, literal terms, inventories, checklists, questionnaires, intentional punctuation, necessary uncertainty and domain terminology. A flagged phrase can be retained with a reason. Zero highlights and numeric scores are not publication gates. Never invent metrics, experiences, opinions or failures to satisfy a style marker.
When This Skill Applies
- Generating any prose, documentation, or written content
- Reviewing or editing existing documents
- User mentions "AI detection", "writing quality", "authentic voice"
- User asks to "make it sound more natural" or "less robotic"
- Creating marketing copy, documentation, or communications
Detection Categories
Legacy High-Priority Patterns (Review in Context)
These phrases can be uninformative in some contexts; none identifies content as AI-generated:
- Corporate Buzzwords: "seamlessly integrates", "cutting-edge", "revolutionary", "next-generation", "comprehensive solution"
- Vague Intensifiers: "dramatically improves", "significantly enhances", "vastly superior"
- Formulaic Transitions: "Moreover,", "Furthermore,", "Additionally,", "In conclusion,"
- Performative Language: "aims to provide", "strives to achieve", "designed to enhance"
- Academic Passive: "It has been observed that...", "It can be argued that..."
Structural Patterns (Flag When Overused)
- Three-item lists: "reliable, scalable, and secure"
- Em-dash overuse: Multiple em-dashes in a paragraph
- Identical paragraph structure: Topic → 3 points → conclusion repeated
- Balanced hedging: "While X has challenges, it also offers opportunities"
Contextual Patterns (Check Frequency)
Review frequency in the document and language; there is no universal acceptable ratio for these words:
- manifest, revolutionary, next-generation
- robust, scalable, comprehensive
- synergy, leverage, utilize
Replacement Guidelines
| Instead of |
Use |
| "plays a crucial role" |
"handles" / "manages" / "does" |
| "seamlessly integrates" |
"works with" / "connects to" |
| "cutting-edge" |
"new" / "recent" / specific tech name |
| "Moreover," |
[just start the next sentence] |
| "comprehensive solution" |
[specific description of what it does] |
| "dramatically improves" |
[specific metric: "reduces latency by 40%"] |
| "robust" |
"handles X requests/second" / "99.9% uptime" |
Editorial Features to Consider
Use these only when relevant and supported by the supplied material:
- Specific opinions: "I prefer X because..." not "X is preferred"
- Acknowledged trade-offs: "This approach sacrifices Y for Z"
- Real-world constraints: "Budget limited us to..."
- Uncertainty where appropriate: "We're not sure yet whether..."
- Varied sentence structure: Mix short and long, different openings
- Domain-specific vocabulary: Use actual technical terms, not generic descriptions
Application Process
When generating or reviewing content:
- Scan for phrase patterns and explicitly mandated style rules
- Count contextual pattern frequency
- Check structural variety
- Suggest edits grounded in the source; retain intentional phrasing with a reason
- Verify facts, author intent, uncertainty and protected content survive the edit
Examples
Before (Generic Wording)
The platform seamlessly integrates cutting-edge technology to dramatically improve workflow efficiency. Moreover, it plays a crucial role in enabling next-generation solutions. In conclusion, this comprehensive approach transforms how teams collaborate.
After (Specific Wording; Requires Supporting Facts)
The platform connects to existing tools through standard APIs. Initial tests show 40% faster task completion. Teams report fewer context switches between applications.
Script Reference
The Python scripts/pattern_scanner.py is a legacy regex scanner, not the contextual diagnostic implementation. It:
- Counts pattern frequencies
- Labels matches using legacy severity categories; these are advisory absent a user rule
- Generates replacement suggestions
- Preserves the deprecated numeric
authenticity_score (0–100) and grade for compatibility, with a deprecation notice; neither measures authorship or publication readiness
For contextual programmatic review, use WritingValidationEngine.diagnose(content, options) or the exported diagnoseWriting API. Results include UTF-16 spans, context, explanations and reasoned exceptions. They carry publicationGate: false. The Python scanner does not implement these context or exception fields.
Integration
This skill works with:
/writing-validator command for explicit validation
writing-validator agent for deep analysis
- Content tasks when this skill is invoked; invocation is not proof of runtime integration
References
- @$AIWG_ROOT/agentic/code/addons/voice-framework/README.md — Voice framework for target style profiles
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md — Parsing content requirements accurately
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context for documentation quality
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for writing-related commands
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Research patterns before making writing recommendations
1---2name: ai-pattern-detection3description: Review editorial phrase patterns and suggest contextual alternatives; legacy name does not imply authorship detection. Use when reviewing or editing content, or when the user mentions authenticity or natural voice.4---56# AI Pattern Detection Skill78## Purpose910Review phrase patterns and suggest edits that fit the author’s intent and audience. This skill does not detect authorship or certify naturalness.1112These are editorial preferences, not evidence of human or AI authorship. Apply only the requirements chosen by the author or project; other phrase and structure suggestions are advisory. Preserve quotations, code, literal terms, inventories, checklists, questionnaires, intentional punctuation, necessary uncertainty and domain terminology. A flagged phrase can be retained with a reason. Zero highlights and numeric scores are not publication gates. Never invent metrics, experiences, opinions or failures to satisfy a style marker.1314## When This Skill Applies1516- Generating any prose, documentation, or written content17- Reviewing or editing existing documents18- User mentions "AI detection", "writing quality", "authentic voice"19- User asks to "make it sound more natural" or "less robotic"20- Creating marketing copy, documentation, or communications2122## Detection Categories2324### Legacy High-Priority Patterns (Review in Context)2526These phrases can be uninformative in some contexts; none identifies content as AI-generated:27281. **Corporate Buzzwords**: "seamlessly integrates", "cutting-edge", "revolutionary", "next-generation", "comprehensive solution"292. **Vague Intensifiers**: "dramatically improves", "significantly enhances", "vastly superior"303. **Formulaic Transitions**: "Moreover,", "Furthermore,", "Additionally,", "In conclusion,"314. **Performative Language**: "aims to provide", "strives to achieve", "designed to enhance"325. **Academic Passive**: "It has been observed that...", "It can be argued that..."3334### Structural Patterns (Flag When Overused)35361. **Three-item lists**: "reliable, scalable, and secure"372. **Em-dash overuse**: Multiple em-dashes in a paragraph383. **Identical paragraph structure**: Topic → 3 points → conclusion repeated394. **Balanced hedging**: "While X has challenges, it also offers opportunities"4041### Contextual Patterns (Check Frequency)4243Review frequency in the document and language; there is no universal acceptable ratio for these words:44- manifest, revolutionary, next-generation45- robust, scalable, comprehensive46- synergy, leverage, utilize4748## Replacement Guidelines4950| Instead of | Use |51|-----------|-----|52| "plays a crucial role" | "handles" / "manages" / "does" |53| "seamlessly integrates" | "works with" / "connects to" |54| "cutting-edge" | "new" / "recent" / specific tech name |55| "Moreover," | [just start the next sentence] |56| "comprehensive solution" | [specific description of what it does] |57| "dramatically improves" | [specific metric: "reduces latency by 40%"] |58| "robust" | "handles X requests/second" / "99.9% uptime" |5960## Editorial Features to Consider6162Use these only when relevant and supported by the supplied material:63641. **Specific opinions**: "I prefer X because..." not "X is preferred"652. **Acknowledged trade-offs**: "This approach sacrifices Y for Z"663. **Real-world constraints**: "Budget limited us to..."674. **Uncertainty where appropriate**: "We're not sure yet whether..."685. **Varied sentence structure**: Mix short and long, different openings696. **Domain-specific vocabulary**: Use actual technical terms, not generic descriptions7071## Application Process7273When generating or reviewing content:74751. **Scan** for phrase patterns and explicitly mandated style rules762. **Count** contextual pattern frequency773. **Check** structural variety784. **Suggest** edits grounded in the source; retain intentional phrasing with a reason795. **Verify** facts, author intent, uncertainty and protected content survive the edit8081## Examples8283### Before (Generic Wording)84> The platform seamlessly integrates cutting-edge technology to dramatically improve workflow efficiency. Moreover, it plays a crucial role in enabling next-generation solutions. In conclusion, this comprehensive approach transforms how teams collaborate.8586### After (Specific Wording; Requires Supporting Facts)87> The platform connects to existing tools through standard APIs. Initial tests show 40% faster task completion. Teams report fewer context switches between applications.8889## Script Reference9091The Python `scripts/pattern_scanner.py` is a **legacy regex scanner**, not the contextual diagnostic implementation. It:92- Counts pattern frequencies93- Labels matches using legacy severity categories; these are advisory absent a user rule94- Generates replacement suggestions95- Preserves the deprecated numeric `authenticity_score` (0–100) and `grade` for compatibility, with a deprecation notice; neither measures authorship or publication readiness9697For contextual programmatic review, use `WritingValidationEngine.diagnose(content, options)` or the exported `diagnoseWriting` API. Results include UTF-16 spans, context, explanations and reasoned exceptions. They carry `publicationGate: false`. The Python scanner does not implement these context or exception fields.9899## Integration100101This skill works with:102- `/writing-validator` command for explicit validation103- `writing-validator` agent for deep analysis104- Content tasks when this skill is invoked; invocation is not proof of runtime integration105106## References107108- @$AIWG_ROOT/agentic/code/addons/voice-framework/README.md — Voice framework for target style profiles109- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md — Parsing content requirements accurately110- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context for documentation quality111- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for writing-related commands112- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Research patterns before making writing recommendations