CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-sync

Sync files with centralized storage. Use when your coordinator or another Worker notifies you of file updates (config changes, task files, shared data, collaboration artifacts).

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./manager/agent/hermes-worker-agent/skills/file-sync/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 concise, largely actionable skill with a clear example workflow and a properly-sized structure whose referenced script is real. The main weakness is the absence of any validation step around the batch push operation (confirm-to-sender is prescribed without verifying the push), plus an unexplained `hermes-sync` command that does not match the bundled `hermes-sync.py` path.

Suggestions

Add a verification checkpoint after push — e.g., check the script's exit status or list the pushed files (or a --dry-run flag) — before confirming to the sender, so the batch write has a feedback loop.

Reconcile the `hermes-sync` invocation with the bundled `scripts/hermes-sync.py`: either reference its actual path or state that it is installed on PATH.

Trim the redundancy between the 'When to use' bullets and the example workflow, which repeats the same hermes-sync and push-shared.sh commands a second time.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no padding that explains concepts Claude already knows. Minor over-explanation remains — the 'When to use' bullets and example workflow restate commands already shown above — keeping it just below the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Guidance is mostly executable: `hermes-sync`, `cat shared/tasks/{task-id}/spec.md`, and `bash ./skills/file-sync/scripts/push-shared.sh tasks/{task-id}/ --exclude "spec.md"` with a concrete worked example (st-01) and a real script in the bundle. The minor gap is inconsistent invocation — push-shared.sh gets a full relative path while `hermes-sync` appears as a bare command despite the bundle containing `scripts/hermes-sync.py`, so the reader cannot tell how to run it from the skill.

4 / 5

Workflow Clarity

The example workflow gives a clear sequence (sync → read spec → work → push → confirm), but pushing a directory to MinIO is a batch write with no verification checkpoint — the skill says 'Always confirm to the sender after push completes' without ever checking that the push succeeded or what was uploaded. Per the rubric's cap, a batch operation without validation cannot score above 3.

3 / 5

Progressive Disclosure

Content is well organized into focused sections with the only external reference (`scripts/push-shared.sh`) being a real one-level-deep bundle file, appropriate for a skill of this size. It falls short of 5 because `scripts/hermes-sync.py` exists in the bundle yet is never linked from the body — the `hermes-sync` command's provenance is undocumented.

4 / 5

Total

15

/

20

Passed

Description

65%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 has a strong, explicit 'Use when' trigger clause with natural terminology for a multi-agent coordination context, but the capability statement itself is generic — it says only 'Sync files with centralized storage' without concrete actions or the push/pull split. Expanding the what-clause would raise both specificity and completeness.

Suggestions

Enumerate the concrete operations in the what-clause, e.g., 'Pull config, skills, and shared task files from central storage and push results back' instead of the single generic 'Sync files'.

Add natural trigger terms users would say verbatim, such as 'push results', 'MinIO', or 'shared/tasks' — currently only the notification phrasing is covered.

State what gets synced (config, skills, task/project files) in the description so it is distinguishable from generic file-transfer skills.

DimensionReasoningScore

Specificity

The description names the domain ("Sync files with centralized storage") but offers only one generic action — 'sync' — without concrete operations like pulling config or pushing results. It names the domain with minimal/generic actions, matching the score-2 anchor ('Processes PDF files'); it does not reach 3 because no 1-2 concrete actions are enumerated.

2 / 5

Completeness

Both parts are present: what ("Sync files with centralized storage") and an explicit when ("Use when your coordinator or another Worker notifies you of file updates...") with concrete trigger phrases. It falls short of anchor 5 because the 'what' is thin — a single vague action with no mention of pull/push or which artifacts, whereas the 5-anchor shows a comprehensive multi-action statement.

4 / 5

Trigger Term Quality

Trigger phrases are natural for this environment: "file updates", "config changes", "task files", "shared data", "collaboration artifacts", and "coordinator or another Worker notifies you" — phrasing a coordinator would actually use. It misses a few natural variations (e.g., 'push results', 'MinIO', 'shared/'), placing it just below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The coordinator/Worker notification framing carves out a distinct niche unlikely to fire for unrelated skills. Minor overlap risk remains with generic file-handling skills via broad terms like 'file updates' and 'shared data', keeping it below the clear-niche anchor 5.

4 / 5

Total

14

/

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

agentscope-ai/AgentTeams

Path

manager/agent/hermes-worker-agent/skills/file-sync/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.