CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

avoid-ai-writing

Audit and rewrite content to remove 21 categories of AI writing patterns with a 43-entry replacement table

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/avoid-ai-writing/SKILL.md

The canonical home for this skill is avoid-ai-writing in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

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

A well-organized, concise overview of a genuinely useful single-purpose skill, with a clear output contract and a built-in second-pass validation step. Its central weakness is that the skill's core assets — the 43-entry replacement table and the 21 category definitions — are named but never delivered in SKILL.md or any bundle file, leaving execution details underspecified.

Suggestions

Create a references/replacement-table.md containing the actual 43-entry table (flagged term → plainer alternative) and link to it from a dedicated section, so the skill's core data is actually available at execution time.

Add the per-category definitions (or a references/patterns.md) so 'What It Detects' reads as scannable structure rather than a single run-on sentence listing 21 categories.

Make the second-pass audit a closed feedback loop: state explicitly that if any tells survive the rewrite, they should be fixed and the audit re-run until the text is clean.

DimensionReasoningScore

Conciseness

The body is lean with no padding or explanations of concepts Claude already knows; the 'What It Detects' section packs 21 categories into one dense informational sentence. It fits anchor 4 ('efficient; minor instances that could be trimmed') rather than 5 because the run-on category list could be tightened or tabularized.

4 / 5

Actionability

The Example section gives a concrete worked input and enumerates the four output sections ('Issues found', 'Rewritten version', 'What changed', 'Second-pass audit'), which is more than high-level hints — but the core operational data, the '43-entry replacement table' and per-category definitions, appears nowhere: not inline and not in any bundle file (no references/, scripts/, or assets/ exist). This matches anchor 3 ('some concrete guidance but incomplete; missing key details'), ruling out 4 and keeping it above 2.

3 / 5

Workflow Clarity

The four-section output format implies a clear audit→rewrite→summarize→re-audit sequence, and 'Second-pass audit — re-reads the rewrite to catch any surviving tells' is an explicit validation checkpoint. It falls short of anchor 5 because there is no error-recovery loop (e.g., 'if tells survive the rewrite, fix and re-run the audit'); this is prose editing, not a destructive or batch operation, so no cap applies.

4 / 5

Progressive Disclosure

Sections are well-organized and the file is under 50 lines, but the body repeatedly names a '43-entry replacement table' and 21 category definitions that clearly belong in a separate reference file, and no references/ directory exists — the claimed detail content is simply absent. The under-50-lines exception for scoring 5 requires no need for external references, which does not hold here, so it sits at anchor 3 ('some structure but could be better organized').

3 / 5

Total

14

/

20

Passed

Description

53%Weight 40%Scale 1-5

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

A clear, third-person, appropriately concise description that names its niche and two concrete actions with quantified scope (21 categories, 43 entries). Its main gaps are the complete absence of a 'Use when...' trigger clause and thin coverage of the natural phrasings users would use to invoke it.

Suggestions

Add an explicit trigger clause, e.g.: 'Use when the user asks to remove AI-isms, clean up AI writing, or make text sound less like AI.'

Include the natural synonyms users actually say — 'AI-isms', 'make this sound less like AI', 'humanize', 'machine-generated text' — so the description triggers on real user phrasings.

State the concrete outputs (flagged issues, rewritten text, second-pass re-audit) to lift specificity beyond two generic verbs.

DimensionReasoningScore

Specificity

The description offers exactly two concrete actions ('Audit and rewrite content to remove 21 categories of AI writing patterns') plus a quantified table ('43-entry replacement table'), naming the domain clearly. It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') — anchor 4 requires several specific actions, and coverage of what the audit produces is absent.

3 / 5

Completeness

It clearly answers 'what' ('Audit and rewrite content to remove 21 categories of AI writing patterns with a 43-entry replacement table') but has no 'Use when...' clause or equivalent explicit trigger guidance, which the guidelines cap at 3. The 'when' is only weakly implied by the domain itself.

3 / 5

Trigger Term Quality

'AI writing patterns', 'audit', and 'rewrite' are phrases a user would naturally say when they need this skill, but common variations users actually use — 'AI-isms', 'make this sound less like AI', 'humanize this text', 'machine-generated' — are missing. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than 4.

3 / 5

Distinctiveness Conflict Risk

The niche — detecting and removing AI writing patterns via a replacement table — is a clear specialty distinct from generic editing or proofreading skills, and 'AI writing patterns' is an unlikely trigger for unrelated skills. Minor overlap risk remains with general 'improve my writing' requests, matching anchor 4 ('mostly distinct; minor overlap risk') rather than 5.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/avoid-ai-writing/SKILL.md

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.