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

77%

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 ./.claude/skills/anthropic-docs-updater/SKILL.md

The canonical home for this skill is anthropic-docs-updater in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

62%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 workflow itself is exemplary — clearly sequenced, checklist-validated, with rollback recovery — but it is wrapped in roughly triple the tokens it needs: the workflow is restated in Overview, Quick Reference, and Common Commands. The commands are mostly executable, though the fetch-docs flags and output directories documented in Step 2 do not match the shipped script.

Suggestions

Cut the duplicated presentations: keep the full Update Workflow section and delete the Overview's step list, the Quick Reference tables, and the overlapping Common Commands block, or fold the few non-duplicate commands into the step bodies.

Align Step 2 with the actual fetch-docs.py: either add the --api-docs / --claude-code-docs flags and the temp/sdk-docs/ output dirs to the script, or rewrite the step to use only the existing --github-readmes / --all flags and the real ./temp/docs output path.

Trim or relocate inline detail: the 20-line example update report and the cron/Automation Schedule examples could move to a references file or be cut, bringing SKILL.md closer to an overview.

DimensionReasoningScore

Conciseness

The same workflow is presented three times — the Overview's 5-step list, the full 'Update Workflow' section, and again as the Quick Reference table plus 'Common Commands' — plus a padded Best Practices section ('Why: Can rollback if updates cause issues') and a ~20-line sample report inline. This matches the 2 anchor ('noticeably verbose; several unnecessary... padded sections'): it is not the 1 anchor because nothing explains concepts Claude already knows, but the duplication is avoidable token cost throughout.

2 / 5

Actionability

Most guidance is executable: every step gives concrete bash commands (e.g. 'python scripts/process-docs.py --input temp/ --output processed/'), and the four referenced scripts exist with matching flags for check-updates.py, process-docs.py, and update-skill.py. Not a 5 because two documented fetch commands ('fetch-docs.py --api-docs', 'fetch-docs.py --claude-code-docs') are flags the actual script does not define, and the documented output dirs (temp/sdk-docs/) mismatch the script's default (./temp/docs) — minor but real execution gaps.

4 / 5

Workflow Clarity

The five steps are clearly sequenced, each with Purpose/Process/Outputs, and every step ends with an explicit validation checklist ('- [ ] Structure validation passes (≥4/5)'). Step 5 is a full validation gate with a PASS/FAIL decision and a rollback command ('python scripts/update-skill.py --rollback'), matching the 5 anchor's explicit validation steps, feedback loops for error recovery, and checklists.

5 / 5

Progressive Disclosure

The four bundle scripts are properly referenced one level deep from the body, but there are no reference files at all — the ~450-line SKILL.md inlines content that belongs elsewhere (the example update report, the duplicated Quick Reference tables, Best Practices, cron examples). This fits the 3 anchor ('some structure... content that should be separate is inline') rather than 4, since the duplication and sample output clearly could be split out or trimmed.

3 / 5

Total

14

/

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: third-person, explicit 'Use when' triggers, and a concrete five-step scope. Its main weakness is nominal phrasing ('update detection through... integration and validation') that describes workflow stages rather than the concrete operations (GitHub release checks, fetching docs.claude.com pages, merging into reference files) that would sharpen specificity and trigger matching.

DimensionReasoningScore

Specificity

The description names the domain ('Automated documentation update mechanism for anthropic-expert skill') and enumerates several concrete actions — 'update detection', 'documentation fetching', 'processing', 'skill integration', 'validation' — giving minor gaps in coverage rather than the 1-2 actions of the mid anchor. It sits below the 5 anchor because the actions are named abstractly as workflow stages rather than as concrete operations like 'checks GitHub releases' or 'merges fetched docs into reference files'.

4 / 5

Completeness

Both questions are answered explicitly: the 'what' is 'Automated documentation update mechanism... Five-step workflow from update detection through documentation fetching and processing to skill integration and validation', and the 'when' is a concrete 'Use when...' clause with five trigger phrases. This matches the 5 anchor's requirement of clearly and explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'Use when' clause covers good natural phrasing users would say: 'updating Anthropic documentation, checking for new releases, fetching latest docs, keeping anthropic-expert current, or synchronizing with Anthropic product changes'. Not a 5 because common variations users would actually type — 'SDK version', 'changelog', 'release notes', 'Claude Code update' — are absent from the trigger list.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — keeping the anthropic-expert skill synchronized with Anthropic product changes — and triggers like 'keeping anthropic-expert current' are unmistakable. Minor overlap risk remains because 'updating Anthropic documentation' could also match a general request to read or write Anthropic docs rather than to run this updater, keeping it below the 5 anchor's 'minimal conflict risk'.

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

.claude/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.