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 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.

DimensionReasoningScore

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.

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.