CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-hygiene

Read before writing or editing any SKILL.md, or any research/audit doc in .gemini/internal-docs/research/. Covers the two standing rules for living-reference prose - state current behavior only, and prefer plain, short wording - plus the grep sweep to run before calling a doc clean. PRDs are the deliberate exception (they keep a correction trail).

70

Quality

88%

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

The canonical home for this skill is skill-hygiene in netalertx/NetAlertX

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

The body is a lean, highly actionable reference: a concrete smell-to-fix table, copy-paste grep sweeps, and explicit validation via the pair-check script. Its only weaknesses are slight repetition of the PRD exception and an implicit rather than explicitly ordered workflow.

DimensionReasoningScore

Conciseness

Dense, information-rich prose with no explanation of concepts Claude already knows; the smell/why/fix table delivers maximal information per token. Only minor trimming exists: the PRD exception is explained both in the intro ("belong in PRDs... never in a skill body") and again at the end ("This does not apply to PRDs... per prd-writing"), and a few sentences could be tightened. Anchor 4 (efficient, minor trimming possible), not 5 due to that slight redundancy, well above anchor 3.

4 / 5

Actionability

Fully executable guidance: copy-paste-ready grep commands in the sweep section, a smell/why/fix table quoting exact offending phrases with their fixes, and a named validation script ("scripts/check_skill_pairs.py") with an explanation of what it flags. Matches anchor 5's copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

The sequence is discernible and validated: apply the rules, run the grep sweep, "Read every hit in context", fix the violations, then sync the three trees, with checkpoints (the sweep itself, the pair-check script, and the manual-diff advice). But the steps are presented as reference sections rather than an explicitly ordered procedure with numbered steps, leaving minor gaps that fit anchor 4 rather than anchor 5's explicit sequenced workflow with feedback loops.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so the ~55-line body is appropriately self-contained for a simple, single-purpose skill. Sections are well-organized with clear headers, and external pointers (skills-index, prd-writing, check_skill_pairs.py) are one level deep and well-signaled, matching anchor 5 per the simple-skill guideline.

5 / 5

Total

18

/

20

Passed

Description

87%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.

The description explicitly answers both what and when with concrete, natural trigger phrases, and it delineates a distinct niche with an explicit PRD exception. Its main weakness is a coverage mismatch: it promises "two standing rules" while the body teaches three rules (including the no-em-dash rule) plus the three-tree sync requirement.

Suggestions

Update "the two standing rules" to reflect the actual rule count, or briefly name the additional rules (the no-em-dash rule and the three-tree sync requirement) so the description's coverage matches the body.

Add a few broader natural trigger terms (e.g. "skills", "documentation cleanup") so the skill also fires on phrasings that do not literally mention SKILL.md or the research/ directory.

DimensionReasoningScore

Specificity

Lists several concrete actions ("state current behavior only", "prefer plain, short wording", "plus the grep sweep to run before calling a doc clean", "PRDs are the deliberate exception"), but it advertises "the two standing rules" while the body actually teaches three rules plus cross-tree sync, so coverage has minor gaps. This matches anchor 4 (several specific actions, minor gaps) rather than anchor 5's comprehensive coverage, and is well above anchor 3's 1-2 actions.

4 / 5

Completeness

Both questions are answered explicitly: what ("Covers the two standing rules for living-reference prose... plus the grep sweep to run before calling a doc clean") and when ("Read before writing or editing any SKILL.md, or any research/audit doc in .gemini/internal-docs/research/") with concrete trigger phrases. This is exactly anchor 5; the explicit 'when' clause also avoids the completeness cap of 3.

5 / 5

Trigger Term Quality

Natural trigger phrases like "writing or editing any SKILL.md" and "research/audit doc" match what a user would say, supplemented by "grep sweep", "PRDs", and "correction trail". A few natural terms are missing (e.g. "skills" generically, "documentation", "cleanup"), fitting anchor 4 rather than the sparse keyword set of anchor 3 or the synonym-complete coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (living-reference prose hygiene for SKILL.md and audit docs) with distinct triggers, and actively manages the boundary with its sibling skill via "PRDs are the deliberate exception (they keep a correction trail)". Matches anchor 5's clear niche with minimal conflict risk, not anchor 4 which would require unaddressed overlap with a closely related skill.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

netalertx/NetAlertX

Path

.gemini/skills/skill-hygiene/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.