CtrlK
BlogDocsLog inGet started
Tessl Logo

spatie-package-skeleton

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

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
freekmurze/dotfiles
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.