CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-updater

Provides automated documentation updates by analyzing git changes between the current branch and the last release tag. Performs git diff analysis to identify modifications, then updates README.md, CHANGELOG.md following Keep a Changelog standard, and discovers documentation folders for contextual updates. Use when preparing a release, maintaining documentation sync, or before creating a pull request. Triggers on "update docs", "update changelog", "sync documentation", "update readme", "prepare release documentation".

66

Quality

83%

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

The canonical home for this skill is giuseppe-trisciuoglio/developer-kit

SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, well-sequenced skill with strong verification and approval gates, but the key write step ships placeholder pseudocode that would destroy the existing changelog if run literally, and one reference pointer misdescribes its target file.

Suggestions

Replace the Phase 8 `cat > CHANGELOG.md << 'EOF'` snippet with a safe, executable approach that actually uses the existing content (e.g., an Edit-tool insertion of the new `## [Unreleased]` section, or an awk/sed prepend), removing the '[New content goes here]' / '[Rest of existing changelog]' placeholders.

Make Phase 4 concrete: inline the actual command or logic for parsing conventional commits into Keep a Changelog sections, since references/examples.md holds sample transcripts, not the promised 'detailed bash commands and changelog templates'.

Align the Phase 4/6 reference pointers with what references/examples.md really contains (examples, troubleshooting, advanced filtering) so navigation claims match the bundle.

DimensionReasoningScore

Conciseness

The body is efficient — it never explains git or changelog concepts Claude already knows, and each bash block is purposeful. Minor trimmable padding keeps it below 5: the Phase 7 markdown summary template with placeholder values, and overlapping Best Practices / Constraints lists that repeat phase-level guidance.

4 / 5

Actionability

Most phases give runnable bash (git describe, diff --name-status, folder discovery), but the most critical step — Phase 8's changelog write — is placeholder pseudocode: `cat > CHANGELOG.md << 'EOF'` with "[New content goes here]" and "[Rest of existing changelog]" would truncate the file if executed, and the read `CURRENT_CHANGELOG` variable is never used. Phase 4 also defers the commit-parsing logic to references/examples.md, which contains session transcripts rather than the claimed 'detailed bash commands and changelog templates'. This lands between the 'pseudocode/missing key details' and 'mostly executable' anchors.

3 / 5

Workflow Clarity

Eight clearly sequenced phases with per-phase goals, prerequisite checks, an explicit user-approval checkpoint (Phase 7), and post-edit verification (git diff --stat, spot-check, repo validation commands) — so the destructive/batch cap does not apply. It falls short of 5 only because there is no explicit error-recovery loop (e.g., what to do when the post-edit diff looks wrong).

4 / 5

Progressive Disclosure

Good structure: an overview body with well-signaled, one-level-deep pointers to `references/examples.md` (a real 354-line file) at three points, covering session transcripts and troubleshooting as claimed. Below 5 because the Phase 4 and Phase 6 pointers over-describe that file ('detailed bash commands and changelog templates', 'discovery patterns and update strategies') relative to what it actually contains, a minor navigation gap.

4 / 5

Total

15

/

20

Passed

Description

92%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: concrete third-person actions, an explicit use-when clause, and literal trigger phrases with good synonym coverage. Only minor trigger-term variations are missing.

DimensionReasoningScore

Specificity

Multiple concrete actions are named: "analyzing git changes between the current branch and the last release tag", "Performs git diff analysis to identify modifications", "updates README.md, CHANGELOG.md following Keep a Changelog standard", and "discovers documentation folders" — comprehensive coverage of the skill's actions, matching the top anchor. Only the trailing "contextual updates" phrase is slightly soft, which is not enough to drop below 5.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' via concrete actions (git diff analysis, updating README.md/CHANGELOG.md per Keep a Changelog, discovering doc folders) and the 'when' via both an explicit clause — "Use when preparing a release, maintaining documentation sync, or before creating a pull request" — and literal trigger phrases, mirroring the top anchor example.

5 / 5

Trigger Term Quality

"Triggers on 'update docs', 'update changelog', 'sync documentation', 'update readme', 'prepare release documentation'" covers natural user phrasing well with synonym variation (docs/documentation/readme/changelog). A few common phrases are missing (e.g., "release notes", "what changed since the last release"), so it fits the 'good coverage, a few natural terms missing' anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

The release-tag-to-branch diff workflow with Keep a Changelog formatting carves out a clear niche with distinct triggers; overlap risk with generic doc-editing or commit-message skills is minimal. It stays in third person ("Provides", "Performs") with no voice penalty.

5 / 5

Total

19

/

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

giuseppe-trisciuoglio/developer-kit

Path

plugins/developer-kit-core/skills/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.