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?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is an excellent skill description that clearly defines what it does (re-imports Spatie package docs on spatie.be), when to use it (after merging doc PRs or on explicit user request), and provides multiple natural trigger phrases along with concrete examples of repo name arguments. It is highly specific, distinctive, and complete.

DimensionReasoningScore

Specificity

Lists concrete actions: 're-importing docs for a given repo', 'Update Spatie package documentation on spatie.be'. Also specifies it takes a repo name argument with examples like 'backup', 'laravel-medialibrary', 'laravel-pdf'.

3 / 3

Completeness

Clearly answers both 'what' (re-imports docs for a Spatie repo on spatie.be) and 'when' (after merging a PR touching docs/, or when user says specific trigger phrases). Explicit 'Use after/when' clause is present.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'update docs for [package]', 'rebuild docs for [repo]', 'import docs for [repo]', '/update-spatie-docs [repo-name]', 'merging a PR that touches docs/'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — scoped specifically to Spatie package documentation on spatie.be, with a specific slash command '/update-spatie-docs' and named repo examples. Very unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

100%

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

This is an excellent, focused operational skill. It provides exactly the project-specific knowledge Claude needs (the alias, the double-run pattern, the cache lag behavior) without explaining anything Claude already knows. The workflow is clear with a concrete verification step and explicit failure detection.

DimensionReasoningScore

Conciseness

Every sentence adds value. The explanation of `ar` alias is necessary project-specific knowledge Claude wouldn't have. The note about running twice and the cache behavior are non-obvious operational details. No padding or concept explanations.

3 / 3

Actionability

Provides exact, copy-paste-ready bash commands with clear placeholders. The verification step includes a concrete curl command with grep pattern. The fallback behavior is explicitly described so Claude knows what a failure looks like.

3 / 3

Workflow Clarity

Clear three-phase workflow: run command (twice), verify with curl, handle cache lag. The verification step includes explicit feedback loop (check, wait, retry) and describes what failure looks like (fallback title). For this simple operational task, the sequence is unambiguous.

3 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines. Content is well-organized into Command and Verification sections. No external references are needed, and no content is unnecessarily inlined. Structure is appropriate for the scope.

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.

Validation11 / 11 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.