update-spatie-docs
Update Spatie package documentation by importing docs for a given repo. Use when the user says 'update docs for [package]', 'import docs for [repo]', or invokes /update-spatie-docs [repo-name]. Takes a repo name argument (e.g., 'backup', 'laravel-medialibrary').
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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 a narrow, specific task with concrete actions, explicit trigger conditions, and distinctive terminology. It follows the recommended pattern of 'what it does' + 'Use when...' with natural trigger phrases and examples. The description is concise yet comprehensive, making it easy for Claude to select this skill precisely when needed.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lists concrete actions: 'Update Spatie package documentation by importing docs for a given repo' and specifies it takes a repo name argument with examples like 'backup', 'laravel-medialibrary'. These are specific, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (update Spatie package documentation by importing docs for a given repo) and 'when' (explicit 'Use when' clause with three distinct trigger patterns). Both are well-articulated. | 3 / 3 |
Trigger Term Quality | Includes highly natural trigger phrases: 'update docs for [package]', 'import docs for [repo]', '/update-spatie-docs [repo-name]', plus specific repo name examples. These closely match what a user would actually type. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a very specific niche (Spatie package documentation import) with unique trigger terms like 'Spatie', '/update-spatie-docs', and specific repo names. 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 simple skill that is maximally concise, fully actionable, and well-structured. It provides exactly what Claude needs — a concrete command with a placeholder and a clear fallback — without any unnecessary explanation. A model example of a single-purpose skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean — every token earns its place. No unnecessary explanation of what Spatie is, what docs importing means, or how artisan works. Assumes Claude's competence throughout. | 3 / 3 |
Actionability | Provides a concrete, copy-paste-ready bash command with a clear placeholder for the repo name. The fallback behavior (ask the user) is also explicitly stated. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill with a single action (run one command). The single step is unambiguous, and the edge case (no argument) is handled. Per scoring notes, simple skills can score 3 if the content is clear. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, the content is well-organized with a clear heading, brief explanation, and executable command. No additional files are needed. | 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- freekmurze/dotfiles
- Commit
2c6f6e8
- 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.