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 scaffolding workflow that includes concrete commands, important warnings, and verification steps. The main weakness is that it combines two distinct concerns — package scaffolding and package design patterns — into a single file, making it longer than necessary. Some of the design pattern guidance (enums over strings, early returns, descriptive naming) is general knowledge that Claude already possesses.
Suggestions
Extract the 'Package patterns' and 'API Design Principles' sections into a separate PATTERNS.md file, keeping SKILL.md focused on the scaffolding workflow with a clear reference link.
Remove general software engineering advice Claude already knows (e.g., 'use well-named methods', 'use enums over strings', 'return early instead of else') and keep only Spatie-specific conventions and patterns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~300 lines) and includes some content Claude would already know (e.g., general API design principles like 'use well-named methods', 'use enums over strings'). The workflow section is efficient, but the 'Package patterns' section is extensive and some patterns are general software engineering knowledge rather than package-specific guidance. However, most content does earn its place with concrete examples. | 2 / 3 |
Actionability | The workflow provides fully executable bash commands and PHP code snippets that are copy-paste ready. The sed commands, file rename operations, git commands, and PHP configuration examples are all concrete and specific. The WARNING about not piping stdin to configure.php is a valuable, non-obvious detail. | 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 (the stdin piping issue). The ordering of sed replacements is called out as important with clear reasoning. The workflow covers the full lifecycle from gathering details to reporting results. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections, but it's monolithic — the extensive 'Package patterns' section (covering ~15 patterns) could be split into a separate reference file. The skill tries to serve two purposes (scaffolding workflow + design patterns reference) in one file, making it longer than ideal for the primary use case. | 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 | |
2c6f6e8
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.