CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-config-hygiene

Audit, update, and publish cross-tool agent configuration through Arnesto. Use for agent configuration instructions, AGENTS.md hierarchies, always-loaded rules, skill routing, client wrappers, local runtime boundaries, or instruction/context cleanup.

Quality

85%

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

75%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 tight, well-structured instruction skill: concrete classification and publication directives, an explicit audit-first stance, and verification at each publication phase. Remaining gaps are the absence of executable commands, an only-implied validation retry loop, and time-sensitive authorization metadata inlined in the operational flow.

Suggestions

Name the concrete commands for measurement and review (e.g., the word-count invocation for always-loaded and routed rules, and `git diff --cached` for the staged-diff review) so steps are executable rather than descriptive.

Make the validation feedback loop explicit (e.g., "If canonical checks fail, fix and re-run them before staging or pushing") instead of relying on the implicit "Do not bypass failed checks or hooks".

Move the dated standing-authorization note (2026-10-31) into a clearly labeled authorization subsection so time-sensitive metadata stays out of the operational workflow.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no padding or explanations of concepts Claude already knows ("A safety boundary belongs in documentation plus a targeted workflow unless it must affect most tasks"), so it is above anchor 3; the inline time-sensitive date ("standing publication authorization on 2026-10-31"), which is not placed in an old-patterns/deprecated context, keeps it below anchor 5's every-token-earns-its-place standard.

4 / 5

Actionability

Guidance is mostly executable for an instruction-only skill: it enumerates six classification categories, directs to "Count transitive includes and pointers", "Review the exact staged diff", and to verify the remote "using the `github-host-alias` skill"; it is not a 5 because no copy-paste commands are given (e.g., the word-count command, `git diff --cached`) and "canonical checks" is never named, and not a 3 because the directions are specific rather than high-level hints.

4 / 5

Workflow Clarity

The review workflow is a numbered 7-step sequence with an in-loop checkpoint ("Run focused checks while iterating") and the publication flow has explicit post-stage and post-push verification ("review the exact staged diff", "verify that the remote branch contains the committed update", "Check available CI"), matching anchor 4; it falls short of anchor 5 because the fix-and-revalidate feedback loop is only implied by "Do not bypass failed checks or hooks" rather than stated as an explicit retry step.

4 / 5

Progressive Disclosure

The skill is self-contained with well-organized sections, no nested or buried references, and only an appropriate one-level pointer to the `github-host-alias` skill (no bundle files exist to verify), which fits anchor 4's good structure with minor gaps; it does not reach anchor 5 because at roughly 80 lines it exceeds the under-50-line simple-skill case, and the Shared Ownership and Publication section interleaves standing policy with procedural steps that could be organized as a distinct checklist.

4 / 5

Total

16

/

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.

A strong description: third-person, concise, with an explicit what/when pairing and concrete trigger terms tied to a well-defined niche. The only weakness is trigger coverage stopping short of synonyms and sibling client config file names.

DimensionReasoningScore

Specificity

"Audit, update, and publish cross-tool agent configuration through Arnesto" names three concrete actions in a defined domain, matching the anchor for several specific actions with minor coverage gaps; it is not a 5 because the finer-grained operations the body covers (classify artifacts, measure word counts, validation placement) are not surfaced, and not a 3 because more than 1-2 actions are given.

4 / 5

Completeness

It explicitly answers "what" ("Audit, update, and publish cross-tool agent configuration through Arnesto") and "when" with an explicit "Use for..." clause enumerating concrete trigger conditions, mirroring the anchor-5 example structure; anchor 4's 'when could be more explicit' does not apply since the trigger list is explicit and multi-condition.

5 / 5

Trigger Term Quality

Triggers include natural, concrete phrases users would say ("AGENTS.md hierarchies", "always-loaded rules", "skill routing", "client wrappers", "instruction/context cleanup"), matching good coverage with a few missing terms; it falls short of anchor 5 because sibling file names and synonyms (e.g., CLAUDE.md, .cursorrules, memory files) are absent, and exceeds anchor 3 which expects missing common variations.

4 / 5

Distinctiveness Conflict Risk

"cross-tool agent configuration through Arnesto" plus niche triggers (AGENTS.md hierarchies, always-loaded rules, local runtime boundaries) carve a clear, specialized niche with minimal conflict risk against generic config or git skills; anchor 4's 'minor overlap with closely related skills' is not the better fit because every listed trigger is specific to this niche.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saski/arnesto

Path

.agents/skills/agent-config-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.