CtrlK
BlogDocsLog inGet started
Tessl Logo

content-fix

Autonomous fixer for documentation content issues. Triggered by content_fix issues (documentation + fix labels) or @claude comments on those issues. Reads the issue, identifies affected files, applies fixes following Netwrix writing standards, and pushes a branch. A separate workflow step creates the PR. Asks clarifying questions if the request is ambiguous.

96

1.60x
Quality

96%

Does it follow best practices?

Impact

96%

1.60x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

92%

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-crafted skill that provides clear, actionable guidance for an autonomous documentation fix workflow. It excels at conciseness (no wasted tokens), actionability (real commands and concrete heuristics), and workflow clarity (explicit stop conditions and decision points). The progressive disclosure is adequate with a single external reference to writing standards, appropriate for the skill's scope.

DimensionReasoningScore

Conciseness

Every section earns its place. No unnecessary explanations of what GitHub Actions is, what documentation is, or how git works. The skill assumes Claude's competence and provides only the domain-specific knowledge needed (URL mapping conventions, branch naming, output format).

3 / 3

Actionability

Provides executable bash commands for reading issues, committing, and pushing. The file-finding heuristics are concrete (URL mapping rules, version underscore conventions, fallback search strategy). The output format includes a copy-paste-ready example with exact format requirements.

3 / 3

Workflow Clarity

Six clearly sequenced steps with explicit stop conditions at steps 2C, 3 (ambiguity/images). The workflow includes validation checkpoints: verify file exists (step 2A), check clarity before acting (step 3), and guard rails against meaning changes. The decision tree (confident=act, uncertain=ask) provides clear feedback loops.

3 / 3

Progressive Disclosure

References `docs/CLAUDE.md` for writing standards which is appropriate one-level-deep delegation. However, with no bundle files provided, we can't verify the reference exists. The skill itself is well-structured with clear sections, but all content is inline in a single file — which is appropriate for this skill's complexity, though the Rules section could potentially be a separate reference.

2 / 3

Total

11

/

12

Passed

Description

100%

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

This is a strong skill description that clearly communicates what the skill does, when it should be triggered, and how it operates. It uses specific trigger terms tied to GitHub workflow concepts (labels, issues, comments) and describes a concrete pipeline of actions. The description is concise yet comprehensive, with good distinctiveness from other potential skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: reads issues, identifies affected files, applies fixes following writing standards, pushes a branch. Also mentions asking clarifying questions for ambiguous requests.

3 / 3

Completeness

Clearly answers both what ('reads the issue, identifies affected files, applies fixes following Netwrix writing standards, and pushes a branch') and when ('Triggered by content_fix issues (documentation + fix labels) or @claude comments on those issues').

3 / 3

Trigger Term Quality

Includes natural trigger terms that match how the system would invoke it: 'content_fix issues', 'documentation + fix labels', '@claude comments', 'documentation content issues'. These are specific and actionable triggers.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: documentation content fixes triggered by specific issue labels and comments. The mention of 'content_fix issues', 'documentation + fix labels', and 'Netwrix writing standards' makes it very unlikely to conflict with other skills.

3 / 3

Total

12

/

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

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
netwrix/docs
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.