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 explicit trigger conditions. It uses third person voice, provides concrete examples of repo names, and includes multiple natural trigger phrases including a slash command. The description is concise yet comprehensive.
| 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 including a slash command). | 3 / 3 |
Trigger Term Quality | Includes highly natural trigger terms: '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 say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a very specific niche (Spatie package documentation importing) 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 clearly 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. Fully actionable. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose skill (run one command). The single action is unambiguous: cd to the directory and run the artisan command. The fallback for missing arguments is clear. 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 the command. No external files needed, and the 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- freekmurze/dotfiles
- Commit
05d40bb
- 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.