Guide for creating PHP and Laravel packages using Spatie's package-skeleton-laravel and package-skeleton-php templates. Use when the user wants to create a new PHP or Laravel package, scaffold a package. Also use when building customizable packages — covers proven patterns for extensibility (events, configurable models/jobs, action classes) instead of config option creep.
89
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
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 a strong skill description that clearly identifies its niche (PHP/Laravel package creation with Spatie templates), provides concrete actions and patterns, and includes explicit 'Use when' triggers. It balances breadth (scaffolding, extensibility patterns) with specificity (named templates, specific design patterns like events and action classes), making it easy for Claude to select appropriately.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions and patterns: creating packages using specific templates (Spatie's package-skeleton-laravel and package-skeleton-php), scaffolding packages, and covers specific extensibility patterns (events, configurable models/jobs, action classes). Goes beyond vague language into concrete techniques. | 3 / 3 |
Completeness | Clearly answers both 'what' (guide for creating PHP/Laravel packages using Spatie templates, covers extensibility patterns) and 'when' (explicit 'Use when' clause covering creating new packages, scaffolding, and building customizable packages). Both dimensions are well-addressed. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'PHP', 'Laravel', 'package', 'scaffold', 'Spatie', 'package-skeleton-laravel', 'package-skeleton-php', 'extensibility', 'events', 'configurable models', 'action classes'. Good coverage of both general and specific terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a specific niche (PHP/Laravel package creation using Spatie's specific templates) with clear triggers. Unlikely to conflict with general PHP development skills or Laravel application skills due to the specific focus on package authoring and named templates. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, actionable skill with an excellent step-by-step workflow for scaffolding Laravel packages. The concrete commands, critical warnings (stdin piping), and sed ordering notes demonstrate real-world experience. However, the skill is overly long due to the extensive package patterns section which would be better served as a separate reference file, and some content (basic git commands, general design principles) could be trimmed.
Suggestions
Move the 'Package Patterns' and 'API Design Principles' sections into a separate PATTERNS.md or REFERENCE.md file, with a one-line link from the main SKILL.md
Trim the 'Report to User' step — Claude doesn't need to be told to report a URL and namespace; a brief note suffices
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~300 lines) and includes some content Claude would already know (e.g., basic git commands, what facades are). The API design principles and package patterns sections are useful but quite extensive for a SKILL.md — some could be split into a separate reference file. However, most content is practical and non-redundant. | 2 / 3 |
Actionability | The workflow provides fully executable bash commands and PHP code snippets that are copy-paste ready. The sed replacement commands, file rename operations, and composer commands are concrete and specific. The WARNING about not piping stdin to configure.php is a valuable, actionable insight. | 3 / 3 |
Workflow Clarity | The 6-step workflow is clearly sequenced with numbered steps, includes a verification step (Step 4), and has explicit warnings about pitfalls (stdin piping issue). The ordering note for sed replacements is a critical validation checkpoint. The workflow covers the full lifecycle from gathering details to reporting results. | 3 / 3 |
Progressive Disclosure | The content is structured with clear sections (Workflow, Post-Setup Reference, API Design Principles, Package Patterns), but the package patterns section is very long and would benefit from being split into a separate reference file. The skill is monolithic — everything is inline with no references to external files for the extensive pattern catalog. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
05d40bb
Table of Contents
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.