add-doc-updater

Add automated documentation updater to any Claude skill. Creates a Python sync script that downloads upstream docs, processes markdown for AI consumption, and maintains local cache with configurable refresh. Collects template variables, then delegates implementation through 5-phase workflow. Use when adding auto-updating reference documentation to plugins or skills.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

81%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 well-organized orchestration skill with a clear multi-phase workflow, explicit validation gates, and feedback loops for error recovery. It is mostly concise and actionable with appropriately signaled references; only minor trimming and slight reference-file usage could improve it.

Suggestions

Move the per-variable explanation detail from Phase 0 into the template reference file to tighten the body and push progressive disclosure higher.

Trim the repeated 'Rationale:' lines under Phase 3 quality gates, since the gate names are self-explanatory to Claude.

Inline a minimal substitute-and-delegate example command for Phase 1 so the implementation path is copy-paste ready rather than relying solely on the reference.

Dimension	Reasoning	Score
Conciseness	Largely efficient and well-structured with mermaid diagrams and command blocks rather than padded prose, though the Phase 0 variable explanations and repeated rationale lines add minor over-explanation that could be trimmed.	4 / 5
Actionability	Provides concrete executable commands (ruff, mypy, pyright, uv run) and clear delegation prompts with only minor gaps — the template substitution step relies on a reference file rather than inline code, keeping it just shy of fully copy-paste ready.	4 / 5
Workflow Clarity	A clear 5-phase sequence with explicit validation checkpoints (quality gates gating each step, a 7-point testing checklist) and explicit failure feedback loops back to Phase 1, matching the anchor for clear sequencing with feedback loops.	5 / 5
Progressive Disclosure	Good structure with a single one-level-deep reference (references/doc-updater-template.md) that is clearly signaled; the body is appropriately organized by phases, though some inline variable detail could arguably live in the reference, leaving minor organization gaps.	4 / 5
	Total	17 / 20 Passed

Description

87%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, third-person description that states concrete capabilities and provides an explicit 'Use when' trigger clause. It is mostly specific and clearly distinct, with only minor room for additional synonyms and action coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ('Creates a Python sync script that downloads upstream docs, processes markdown for AI consumption, and maintains local cache with configurable refresh'), listing multiple specific actions but with minor gaps in coverage (link transformation, cooldown enforcement are omitted).	4 / 5
Completeness	Clearly answers 'what' (creates a Python sync script that downloads/processes/maintains docs) and 'when' via an explicit 'Use when adding auto-updating reference documentation to plugins or skills' clause with concrete trigger phrasing.	5 / 5
Trigger Term Quality	Includes natural terms users would say ('documentation updater', 'reference documentation', 'plugins or skills') with good coverage, but lacks common synonyms or file extensions that would push it to a 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (auto-updating documentation pipelines for skills/plugins) with distinct triggers unlikely to fire for unrelated skills, minimal conflict risk.	5 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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: Jamie-BitFlight/claude_skills
Path: plugins/plugin-creator/skills/add-doc-updater/SKILL.md
Commit: c337daf

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.