CtrlK
BlogDocsLog inGet started
Tessl Logo

update-spatie-docs

Update Spatie package documentation on spatie.be by re-importing docs for a given repo. Use after merging a PR that touches docs/, or when the user says 'update docs for [package]', 'rebuild docs for [repo]', 'import docs for [repo]', or invokes /update-spatie-docs [repo-name]. Takes a repo name argument (e.g., 'backup', 'laravel-medialibrary', 'laravel-pdf').

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, single-purpose skill body that delivers copy-paste commands, a concrete verification step with a cache-lag feedback loop, and well-organized sections. It assumes Claude's competence while surfacing only the non-obvious details (the alias, the double-run rationale, cache behavior).

DimensionReasoningScore

Conciseness

Lean body with no basic-concept padding; the few explanations given (why run twice, what 'ar' aliases) are non-obvious details Claude would not otherwise know, so every token earns its place.

3 / 3

Actionability

Provides concrete copy-paste bash commands with the repo-name substitution spelled out, explains the 'ar' alias, and gives an exact curl verification command — fully executable guidance.

3 / 3

Workflow Clarity

Clear sequence of run-command → verify-with-curl, with an explicit validation checkpoint (compare returned title to the Introduction fallback) and a feedback loop ('Wait a moment and curl again') for cache lag.

3 / 3

Progressive Disclosure

A simple under-50-line single-task skill with no need for external references, organized into clear Command and Verification sections; per the simple-skills scoring note this is appropriate without bundled files.

3 / 3

Total

12

/

12

Passed

Description

100%

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 highly specific, third-person description that clearly states the action, supplies natural trigger phrases and a slash-command invocation, and is narrowly scoped to the Spatie docs niche. It answers both what and when without verbosity.

DimensionReasoningScore

Specificity

Lists concrete actions ('re-importing docs', 'update docs for [package]') plus the specific argument mechanism with real example repo names ('backup', 'laravel-medialibrary', 'laravel-pdf').

3 / 3

Completeness

Explicitly answers both 'what' ('Update Spatie package documentation... by re-importing docs') and 'when' ('Use after merging a PR that touches docs/, or when the user says...').

3 / 3

Trigger Term Quality

Includes natural phrases a user would actually say ('update docs for', 'rebuild docs for', 'import docs for') plus the explicit slash-command invocation, giving strong trigger coverage.

3 / 3

Distinctiveness Conflict Risk

Scoped tightly to the Spatie docs site and a specific artisan command, making it highly unlikely to trigger for any unrelated skill.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
freekmurze/dotfiles
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.