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').
96
Quality
95%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%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 a well-crafted skill description with excellent trigger term coverage and completeness. It clearly specifies when to use the skill with explicit trigger phrases and a slash command. The main weakness is that it describes only one action (importing/updating docs) rather than listing multiple specific capabilities.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Spatie package documentation) and the action (importing docs for a given repo), but doesn't list multiple concrete actions - only describes one main action of updating/importing docs. | 2 / 3 |
Completeness | Clearly answers both what (update Spatie package documentation by importing docs) and when (explicit 'Use when' clause with specific trigger phrases and slash command). Also specifies the argument format with examples. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'update docs for [package]', 'import docs for [repo]', '/update-spatie-docs', and includes example repo names like 'backup', 'laravel-medialibrary'. Users would naturally use these phrases. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific triggers: 'Spatie package', '/update-spatie-docs', and specific repo name examples. Very unlikely to conflict with other documentation or import skills due to the Spatie-specific context. | 3 / 3 |
Total | 11 / 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 exemplary simple skill that does exactly what it needs to do with maximum efficiency. It provides a concrete, executable command, handles the edge case of missing arguments, and wastes no tokens on explanations Claude doesn't need.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanation of what Spatie is, what docs importing means, or how artisan commands work. Every line serves a purpose. | 3 / 3 |
Actionability | Provides a complete, copy-paste ready bash command with clear placeholder syntax. The fallback behavior (ask user) is explicit and actionable. | 3 / 3 |
Workflow Clarity | This is a simple single-step skill with one clear action. The workflow is unambiguous: run the command with the repo name, or ask if missing. No multi-step validation needed for a docs import. | 3 / 3 |
Progressive Disclosure | For a skill under 10 lines with a single purpose, no external references are needed. The content is well-organized with a clear header, explanation, and command. | 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
355d067
- 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.