CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sync-agents-docs

Sync AGENTS.md files, skills, and references after buildSrc or convention changes. Use after modifying build plugins, formatting rules, testing conventions, or task names to keep documentation consistent.

Quality

87%

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

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.

An excellent instruction-only skill: a precise change-to-file mapping table, a short sequenced procedure with a verification step, and appropriately compact single-file organization. The only refinements would be trimming the redundant manual-checklist preamble and making the fix-and-re-verify loop explicit.

DimensionReasoningScore

Conciseness

The body is lean (~25 lines) with a dense lookup table, but "This is a manual checklist — `disable-model-invocation: true` means agents cannot execute it autonomously" over-explains a frontmatter flag, and "Human developers should walk through this after buildSrc changes" duplicates the description. These minor trimmable instances match anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

The checklist table maps specific change sources (`spotless.gradle.kts`, `testing-*.gradle.kts`, convention plugins) to exact update targets ("Root `AGENTS.md` Style section", "`style-reference` reference", "`buildSrc/AGENTS.md` plugin table", "`evergreen` skill"), and step 4 gives concrete verification examples ("renamed tasks, removed plugins"). For an instruction-only skill this fully covers the common cases with no real gaps, matching anchor 5.

5 / 5

Workflow Clarity

A clear 4-step sequence (review diff, walk checklist, update, verify) with an explicit final validation step ("Verify no stale references remain") plus a checklist table. It misses anchor 5 because the error-recovery feedback loop (fix a stale reference, re-verify) is only implied rather than explicit; validation is present, so the batch-operation cap of 3 does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references (no references/, scripts/, or assets/ bundle exists); the two well-organized sections (## Checklist, ## How to use) fully satisfy the simple-skill exception for anchor 5.

5 / 5

Total

18

/

20

Passed

Description

83%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 that clearly states both what it does and when to use it, with concrete natural-language triggers tied to a well-defined build-tooling niche. The only weakness is that the sync action itself is never unpacked and a few common synonyms (e.g., gradle, spotless) are absent.

DimensionReasoningScore

Specificity

"Sync AGENTS.md files, skills, and references after buildSrc or convention changes" names the domain and several concrete sync targets (AGENTS.md files, skills, references). It falls short of 5 because it never says what syncing involves (e.g., checking or updating content), and exceeds 3 because it lists more than 1-2 concrete items.

4 / 5

Completeness

It explicitly answers what ("Sync AGENTS.md files, skills, and references after buildSrc or convention changes") and when ("Use after modifying build plugins, formatting rules, testing conventions, or task names") with concrete trigger phrases. The 'when' clause is already explicit and specific, so it is not the anchor-4 case where the trigger guidance could be more explicit.

5 / 5

Trigger Term Quality

"modifying build plugins, formatting rules, testing conventions, or task names" contains natural phrases a developer would actually say after touching build code. Not 5 because common synonyms like "gradle", "spotless", or "CI" are missing; not 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

The buildSrc/convention-change niche with distinct triggers like "buildSrc" and "convention plugins" is mostly distinct with only minor overlap risk against generic doc-update skills. Not 5 because the broad "keep documentation consistent" framing could still collide with other documentation-maintenance skills.

4 / 5

Total

17

/

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

mongodb/mongo-java-driver

Path

.agents/skills/sync-agents-docs/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.