CtrlK
BlogDocsLog inGet started
Tessl Logo

file-edit-in-place

Use when the user names a local file and explicitly asks to clean, rewrite, humanize, or remove AI-writing patterns in that file itself, with minimal targeted edits and post-edit verification.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 lean, well-structured operational contract with fully concrete instructions and an exemplary validation/repair loop for a file-mutation skill. Its weaknesses are mild redundancy across the lens/preconditions/policy sections and heavy dependence on sibling-skill paths whose availability is not verifiable from this skill.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of concept explanations Claude already knows, and it delegates the canonical editing contract to an external skill rather than duplicating it. Minor redundancy keeps it below anchor 5: read-before-write and narrowest-scope guidance repeats across 'Senior-developer implementation lens', 'Preconditions', and 'Editing policy'.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete and executable: exact state fields ('execution_evidence.mutation: executed/not_run'), an explicit pass-counting rule ('Count the initial file mutation as editing pass 1'), enumerated protected regions and preserved properties, and a defined report format. No pseudocode or vague direction remains.

5 / 5

Workflow Clarity

The mutation workflow is clearly sequenced (preconditions, 12-step editing policy, repair path, stop conditions, output) with explicit validation checkpoints: re-read after edit, handoff to preservation-verifier, pass-limit enforcement ('If pass.index has reached pass.max, do not repair'), and a bounded FAIL→repair→re-verify feedback loop. This satisfies the validation requirements for a file-mutating (destructive) skill.

5 / 5

Progressive Disclosure

The body is well sectioned with clearly signaled, purpose-stated, one-level-deep references (handoff-contract.md, skill-graph.json, agency-role-lenses.md), matching the good-structure anchor. It falls short of anchor 5 because the core editing contract is delegated entirely to a sibling path ('../avoid-ai-writing/SKILL.md') that is external to this skill's bundle and cannot be navigated or verified from the skill itself, and no bundle files exist alongside this SKILL.md.

4 / 5

Total

18

/

20

Passed

Description

78%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 strong description with an explicit, specific trigger clause and concrete action verbs that delineate a distinct niche. Its main limitation is that the capability statement lives entirely inside the when-clause, leaving the what only implicitly separated, and it omits several natural synonyms users might use for AI-pattern removal.

Suggestions

Split the description into a leading capability statement (what) followed by the explicit 'Use when...' trigger clause, e.g., 'Edits a named local file in place to remove AI-writing patterns with minimal targeted edits and post-edit verification. Use when the user names a local file and explicitly asks to clean, rewrite, humanize, or de-AI that file.'

Add common natural synonyms users say for this task, such as 'make it sound natural', 'less robotic', or 'sounds like ChatGPT/AI', to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions ("clean, rewrite, humanize, or remove AI-writing patterns" with "minimal targeted edits and post-edit verification"), matching the several-specific-actions anchor. It falls short of anchor 5 because the action coverage is condensed into a trigger clause rather than comprehensively enumerating what the skill does.

4 / 5

Completeness

Both what and when are present: the when is explicit and specific ("Use when the user names a local file and explicitly asks to clean, rewrite, humanize..."), and the what (in-place targeted editing with verification) is stated but only embedded inside the when-clause rather than as its own distinct statement. This is above anchor 3 (which has a missing/weak when) and below anchor 5 (which states what and when as clearly separate explicit parts).

4 / 5

Trigger Term Quality

"clean", "rewrite", "humanize", and "remove AI-writing patterns" are natural phrases a user would say when requesting this. A few common natural terms are missing (e.g., "make it sound natural/less robotic", "sounds like AI/ChatGPT"), so it fits the good-coverage-with-gaps anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — named-file, in-place mutation on explicit user request — and the phrase "in that file itself" explicitly disambiguates from returned-text rewriting skills. Trigger conditions (named file + explicit mutation request) are narrow, minimizing wrong-skill activation.

5 / 5

Total

17

/

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
conorbronsdon/avoid-ai-writing
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.