CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-claude-updater

Auto-update system for Auto-Claude skills and documentation. Use when checking for updates, synchronizing with upstream, updating skills automatically, or managing version compatibility.

Quality

60%

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 ./skills/auto-claude-updater/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 action-oriented with mostly real commands and a clear update sequence, but it is bloated by duplication and inlines a full script that already exists (in better shape) in the bundle. Three sed commands are truncated and unexecutable, the batch-update workflow lacks any validation checkpoints, and the provided CHANGELOG-LATEST.md reference file is never linked.

Suggestions

Replace the inlined 'Automatic Update Script' section with a one-line pointer to scripts/sync-auto-claude-skills.sh, and cut the 'Quick Commands' section that duplicates the Update Workflow steps.

Fix the three truncated sed commands (lines 143, 283, 314) to complete expressions, e.g. sed -i "s/auto-claude-version: .*/auto-claude-version: $LATEST/", matching the working pattern already in scripts/sync-auto-claude-skills.sh.

Add validation checkpoints to the Update Workflow (verify the new version in each SKILL.md after the sed pass, review `git diff` before committing) since it rewrites files across many skills in one batch.

Link the existing references/CHANGELOG-LATEST.md from the changelog-review step instead of instructing the reader to curl the raw upstream changelog.

DimensionReasoningScore

Conciseness

The ~330-line body has several padded and duplicated sections: 'Quick Commands' repeats the same git pull/curl/sync commands later restated as the 4-step 'Update Workflow', and the full 36-line sync script is inlined verbatim even though the actual script exists at scripts/sync-auto-claude-skills.sh (in a better, working form). It avoids explaining basic concepts, so it is not anchor 1, but the duplication and inlining make it noticeably verbose.

2 / 5

Actionability

Most commands are concrete and executable (git fetch/pull, curl to the GitHub releases API, gh release view, the sync script), but three sed snippets are truncated mid-expression (`sed -i "s/auto-claude-version: 2.7.2` with no replacement text or closing quote at lines 143, 283, and 314), which is broken, non-executable code rather than a minor gap. That matches anchor 3 (concrete guidance present but incomplete) rather than 4.

3 / 5

Workflow Clarity

The Update Workflow is a clear 4-step sequence (check version, review changelog, update repo, sync skills), but it is a batch operation — sed -i rewrites every auto-claude-* SKILL.md and cp overwrites reference files — with no validation checkpoints (no post-update version check, no git diff review before commit). Per the rubric guideline, a batch workflow without validation is capped at 3.

3 / 5

Progressive Disclosure

Content that clearly belongs in separate bundle files is inlined: the entire sync script is embedded in the body even though scripts/sync-auto-claude-skills.sh exists in the bundle, and a full GitHub Actions YAML and pre-commit hook are inlined as well. Meanwhile the bundle's references/CHANGELOG-LATEST.md is never referenced from the body — the body tells the reader to curl the changelog instead. The section headers do give some structure, keeping it above anchor 1, but the inlining and the orphaned reference file fit anchor 2.

2 / 5

Total

10

/

20

Passed

Description

66%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 solid description with an explicit 'Use when' clause covering several natural trigger scenarios, which satisfies the completeness floor. Its weakness is a generic 'Auto-update system' framing: the what is a category label rather than concrete actions, and the trigger terms are broadly applicable enough to risk overlapping other maintenance skills.

Suggestions

Replace the generic 'Auto-update system' opening with the concrete operations the skill performs, e.g. 'Check for new Auto-Claude releases, pull upstream updates, and copy upstream docs into skill reference files. ...'

Add distinguishing trigger terms that name the product and artifacts (e.g. 'Auto-Claude release', 'sync skills', 'outdated skill references') so it does not fire on generic 'check for updates' requests.

DimensionReasoningScore

Specificity

The description names the domain ('Auto-update system for Auto-Claude skills and documentation') and gestures at actions via the trigger list ('checking for updates, synchronizing with upstream, updating skills automatically, or managing version compatibility'), but the stated actions are abstract category labels rather than concrete operations like 'pull the latest release' or 'copy upstream docs into skill references'. It sits between anchor 3 (domain plus a couple of concrete actions) and anchor 4; the generic 'Auto-update system' framing keeps it at 3 rather than 4, while the presence of several named actions keeps it above 2.

3 / 5

Completeness

Both parts are present: the 'what' ('Auto-update system for Auto-Claude skills and documentation') and an explicit 'Use when...' clause with multiple trigger scenarios. It falls short of anchor 5 because the 'what' is a category label rather than a concrete enumeration of what the skill actually does (check versions, pull releases, copy docs into references, bump version fields).

4 / 5

Trigger Term Quality

Phrases like 'checking for updates', 'updating skills automatically', and 'managing version compatibility' read as natural user requests. It is not anchor 5 because common synonyms are missing — 'upgrade', 'sync', 'new release', 'changelog', 'outdated' — so a user saying 'is Auto-Claude out of date?' or 'sync my skills' would only partially match.

4 / 5

Distinctiveness Conflict Risk

The 'Auto-Claude' scoping gives it a niche, but the trigger phrases themselves ('checking for updates', 'updating skills', 'version compatibility') are generic and would overlap with other update/maintenance skills. It matches anchor 3 (somewhat specific but could still overlap); it is not 4 because nothing in the triggers distinguishes it from, say, a general dependency-update or skill-maintenance skill.

3 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/auto-claude-updater/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.