CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-writing-tropes

Detect and eliminate common AI writing tropes from prose. Use when drafting, editing, or reviewing text to avoid the predictable patterns that mark AI-generated writing.

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./ai-writing-tropes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, concise skill that effectively catalogs AI writing tropes with specific examples. Its main weakness is the lack of concrete before/after rewrite examples that would show Claude how to fix detected tropes, not just identify them. The progressive disclosure design is sound but the referenced detail files are missing from the bundle.

Suggestions

Add 1-2 concrete before/after examples showing a trope-laden passage rewritten to be more natural, to improve actionability.

Integrate the Quick Self-Check into the workflow steps (e.g., 'Step 2: Run through the self-check questions') and add guidance for what to do if multiple passes are needed.

Provide the referenced files (references/word-choice.md, etc.) in the bundle, or inline the most critical content if the files won't be available.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It doesn't explain what AI writing tropes are in abstract terms — it jumps straight to actionable categories and specific examples. Every section earns its place, and the 'Key offenders' lists provide concrete examples without over-explaining why they're problematic (Claude already knows).

3 / 3

Actionability

The skill provides concrete examples of what to avoid (specific words, patterns, structures) and a useful self-check checklist, but it lacks concrete examples of rewrites — showing a 'before' trope-laden passage and an 'after' corrected version would make it fully actionable. The guidance is 'rewrite that passage' without demonstrating how.

2 / 3

Workflow Clarity

The 4-step workflow (draft → check → rewrite → re-read for density) is clear and appropriately simple for this task. However, there's no explicit validation or feedback loop — for instance, no guidance on what to do if pattern density is still too high after one pass, or how to judge when the piece is 'clean enough.' The self-check list partially compensates but isn't integrated into the workflow steps.

2 / 3

Progressive Disclosure

The structure is well-organized with clear references to six separate detail files (references/word-choice.md, etc.), which is excellent progressive disclosure design. However, no bundle files were provided, so the referenced files don't actually exist in the evaluated bundle, meaning the references are broken pointers. The inline 'Key offenders' summaries partially mitigate this by giving enough to act on without the referenced files.

2 / 3

Total

9

/

12

Passed

Description

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is well-structured with a clear 'Use when' clause and a distinct niche that separates it from general writing or editing skills. However, it could be more specific about what concrete actions it performs (e.g., listing specific tropes or patterns it targets) and could include more natural trigger terms that users would actually say when they want this kind of help.

Suggestions

Add specific examples of the tropes or patterns targeted, e.g., 'Detects and removes overused phrases like "delve into", "it's worth noting", "tapestry", hedging language, and excessive adverbs.'

Expand trigger terms to include natural user phrases like 'sounds like AI', 'make it sound human', 'remove AI clichés', 'robotic tone', or 'ChatGPT-style writing'.

DimensionReasoningScore

Specificity

It names the domain (AI writing tropes in prose) and describes actions (detect, eliminate), but doesn't list specific concrete actions or examples of what tropes are targeted or what the skill actually does beyond 'detect and eliminate.'

2 / 3

Completeness

Clearly answers both what ('Detect and eliminate common AI writing tropes from prose') and when ('Use when drafting, editing, or reviewing text to avoid the predictable patterns that mark AI-generated writing') with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'AI writing tropes', 'drafting', 'editing', 'reviewing text', and 'AI-generated writing', but misses common natural variations users might say such as 'sounds like AI', 'robotic writing', 'clichés', 'make it sound more human', 'natural tone', etc.

2 / 3

Distinctiveness Conflict Risk

This has a clear, specific niche — AI writing trope detection and elimination — that is unlikely to conflict with general editing, proofreading, or style guide skills. The focus on AI-specific patterns makes it distinctly identifiable.

3 / 3

Total

10

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
joshuadavidthomas/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.