CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

67

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/sync-agents-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a lean, well-structured manual checklist with concrete file-to-update mappings and a verification step, scoring highly on actionability, workflow clarity, and progressive disclosure. The only weakness is mild redundancy in the introductory sentences.

Suggestions

Merge the two introductory paragraphs into one sentence to remove the repeated 'after buildSrc changes' framing and tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is short and table-driven, but the intro repeats itself ("manual checklist... Human developers should walk through this after buildSrc changes" then "After modifying buildSrc or build conventions, check whether... need updating"), so it is mostly efficient but could be tightened.

2 / 3

Actionability

The checklist maps each change type to specific, named files and references (e.g., spotless.gradle.kts → style-reference, testing-*.gradle.kts → testing-guide), and the 'How to use' steps are concrete and specific, which is fully actionable for an instruction-only skill.

3 / 3

Workflow Clarity

The 'How to use' section gives a clear four-step sequence ending in an explicit verification checkpoint ("Verify no stale references remain"), satisfying the level-3 anchor for a simple checklist skill.

3 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines with no local bundle files; its two well-organized sections (Checklist table, How to use) and one-level pointers to other repo resources match the simple-skill allowance for a top score.

3 / 3

Total

11

/

12

Passed

Description

75%

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 clearly conveys a well-scoped purpose with an explicit 'Use after...' trigger, but its action vocabulary is limited to 'sync' and its trigger terms are somewhat technical. It is strong on completeness and distinctiveness, slightly weaker on specificity and trigger-term naturalness.

Suggestions

Expand the action set beyond the single verb 'Sync' (e.g., 'Update, regenerate, and reconcile AGENTS.md files, skills, and references') to show multiple concrete actions.

Add more natural-language trigger phrasings a developer might actually say (e.g., 'Use when you changed Gradle build config, renamed a task, or tweaked spotless/formatting rules').

DimensionReasoningScore

Specificity

It names the domain and concrete objects ("Sync AGENTS.md files, skills, and references") but relies on a single action verb ("Sync") rather than listing multiple distinct concrete actions, so it does not reach the level-3 multi-action anchor.

2 / 3

Completeness

It explicitly answers what ("Sync AGENTS.md files, skills, and references") and when ("Use after modifying build plugins, formatting rules, testing conventions, or task names"), matching the level-3 anchor with an explicit trigger clause.

3 / 3

Trigger Term Quality

It lists relevant trigger terms ("build plugins, formatting rules, testing conventions, or task names", "buildSrc") but these lean technical and miss common user phrasings, fitting the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

The niche is narrow and specific (documentation sync after buildSrc/convention changes) with distinct triggers, making it unlikely to fire for the wrong skill.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
mongodb/mongo-java-driver
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.