CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

anthropic-docs-updater

Automated documentation update mechanism for anthropic-expert skill. Five-step workflow from update detection through documentation fetching and processing to skill integration and validation. Use when updating Anthropic documentation, checking for new releases, fetching latest docs, keeping anthropic-expert current, or synchronizing with Anthropic product changes.

Quality

75%

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/anthropic-docs-updater/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 presents an exemplary 5-step workflow structure with per-step validation checklists and a rollback loop, but execution fidelity is weak: two documented fetch commands reference flags that do not exist in the actual scripts, and several scripts are placeholders for behaviors the body promises. Redundant triple presentation of the workflow and duplicated cron/source tables inflate the token cost without adding guidance.

Suggestions

Align the documented commands with the actual scripts: either add the --api-docs and --claude-code-docs flags to fetch-docs.py or replace those Step 2 invocations with the flags that exist (--all/--github-readmes/--output).

Deduplicate the body: the 5-step workflow and update-source lists each appear multiple times (Overview, Update Workflow, Quick Reference) and cron examples appear twice — keep one canonical presentation and slim the rest.

Correct or clearly flag the placeholder behaviors in the workflow text (check-updates.py --docs/--claude-code and process-docs.py do not yet scrape, diff, or merge as Steps 1-3 claim), since following the steps as written will not produce the described outputs like diff-report.txt.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and is mostly operational, but it is noticeably padded with repetition: the 5-step workflow appears three times (Overview list, detailed 'Update Workflow', and the Quick Reference table), the update sources are listed twice, cron examples appear in both 'Best Practices' and 'Automation Schedule', and Best Practices restate Steps 4-5. Fits anchor 3 ('mostly efficient but... could be tightened'); not 2 because the padding is redundant summary rather than explanation of known concepts.

3 / 5

Actionability

Commands look copy-paste ready and reference real bundle scripts, but verified against the actual scripts there are key gaps: `fetch-docs.py` defines only --all/--github-readmes/--output, so the body's `--api-docs` and `--claude-code-docs` invocations (Step 2) would fail with unrecognized arguments, and `check-updates.py --docs/--claude-code` plus `process-docs.py` are placeholders that do not perform the behaviors the body claims (compare to last check date, extract sections, merge, generate diff report). Matches anchor 3 ('incomplete; missing key details'); not 4 because the command/script mismatches are more than minor.

3 / 5

Workflow Clarity

The five steps are clearly sequenced, each with a purpose, validation checklist, and outputs, and Step 5 provides explicit pass/fail decisioning plus a rollback path — a genuine feedback loop for a batch/destructive operation. Minor gaps keep it at anchor 4: Step 2's broken flag invocations break the sequence mid-run, and validation commands depend on external paths (`../../review-multi/scripts/validate-structure.py`, `../anthropic-expert/scripts/search-docs.py`) whose availability is not guaranteed.

4 / 5

Progressive Disclosure

Script references (`scripts/check-updates.py`, etc.) are one level deep, correctly pathed, and all four referenced scripts exist in the bundle, and section headers are well organized. However, everything else is inlined in a single ~450-line SKILL.md with no offloading — the duplicated Quick Reference, cron examples, and Best Practices content that could live in separate reference files. Matches anchor 3 ('some structure but could be better organized; content that should be separate is inline'); not 4 because the duplication is substantial enough that splitting would meaningfully slim the main file.

3 / 5

Total

13

/

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.

Strong description: it states a clear multi-step purpose and pairs it with an explicit, multi-phrase 'Use when...' trigger clause in third person. It is specific to the anthropic-expert maintenance niche, though its action phrasing stays at the workflow level and a few natural synonyms (release notes, changelog, SDK versions) are absent.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ('update detection through documentation fetching and processing to skill integration and validation'), but the actions are workflow-level abstractions rather than concrete operations — it never names the actual sources or mechanisms (e.g., GitHub releases, release notes scraping). Matches anchor 4 ('lists several specific actions; minor gaps in coverage'), not 5, whose examples enumerate fully concrete operations.

4 / 5

Completeness

Explicitly answers both questions: the 'what' is a clearly stated five-step update mechanism, and the 'when' is an explicit 'Use when...' clause with five concrete trigger phrases. This matches anchor 5 ('clearly and explicitly answers both what AND when with concrete trigger phrases'); it is not anchor 4 because the when-clause is already explicit and specific.

5 / 5

Trigger Term Quality

Includes natural phrases users would say: 'updating Anthropic documentation', 'checking for new releases', 'fetching latest docs', 'keeping anthropic-expert current', 'synchronizing with Anthropic product changes'. A few natural terms are missing (e.g., 'release notes', 'changelog', 'SDK versions'), which fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clearly scoped to keeping the anthropic-expert skill current ('for anthropic-expert skill', 'synchronizing with Anthropic product changes'), giving it a distinct niche. There is minor overlap risk with generic documentation-fetching or update-checking skills, matching anchor 4 ('mostly distinct; minor overlap risk') rather than anchor 5's minimal-conflict profile.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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