Describes PHP and Laravel guidelines provided by Spatie. These rules result in more maintainable, and readable code.
59
Quality
49%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/php-guidelines-from-spatie/SKILL.mdQuality
Discovery
22%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 description is too vague and passive, focusing on what the guidelines achieve rather than what the skill does or when to use it. It lacks concrete actions, explicit trigger conditions, and sufficient natural keywords that users would employ when needing PHP/Laravel coding standards assistance.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when writing PHP or Laravel code, reviewing code style, or when the user mentions Spatie, coding standards, or best practices'
Replace 'Describes guidelines' with specific actions like 'Applies coding standards, enforces naming conventions, structures Laravel classes and controllers'
Include more natural trigger terms users would say: 'code style', 'best practices', 'coding conventions', 'clean code', '.php files'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'guidelines' and 'rules' without specifying concrete actions. It doesn't list what the skill actually does (e.g., 'formats code', 'enforces naming conventions', 'structures classes'). | 1 / 3 |
Completeness | The 'what' is weak (just 'describes guidelines') and there is no 'when' clause or explicit trigger guidance. It only states outcomes ('maintainable, readable code') rather than when to use the skill. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords 'PHP', 'Laravel', and 'Spatie' that users might mention, but misses common variations like 'coding standards', 'best practices', 'code style', or 'linting'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Spatie' and 'Laravel' provides some specificity, but 'PHP guidelines' could overlap with other PHP coding standard skills. The lack of specific triggers increases conflict risk. | 2 / 3 |
Total | 6 / 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 solid Laravel/PHP conventions skill with excellent actionability through concrete code examples and clear before/after patterns. The content is well-organized but somewhat lengthy with some redundancy between the main sections and the Quick Reference. For a conventions guide of this scope, splitting detailed subsections into separate files would improve progressive disclosure.
Suggestions
Remove redundant content between main sections and Quick Reference, or consolidate into a single authoritative location for each rule
Consider splitting detailed subsections (Docblock Rules, Control Flow, Naming Conventions) into separate reference files with links from the main SKILL.md
Remove the duplicate mention of nullable syntax ('?string not string|null' appears in both PHP Standards and Type Declarations sections)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundancy (e.g., nullable syntax mentioned twice, some rules repeated in Quick Reference that appear earlier). The Quick Reference section adds value but duplicates content from earlier sections. | 2 / 3 |
Actionability | Provides concrete, executable code examples throughout with copy-paste ready PHP snippets. Clear before/after comparisons (e.g., comments section) and specific patterns to follow for routes, controllers, validation, and Blade templates. | 3 / 3 |
Workflow Clarity | This is a conventions/style guide skill, not a multi-step workflow skill. The single purpose (follow Laravel/PHP conventions) is unambiguous, and the content is well-organized into clear categorical sections with specific rules. | 3 / 3 |
Progressive Disclosure | Content is well-structured with clear section headers, but it's a monolithic document that could benefit from splitting detailed sections (like Docblock Rules, Control Flow examples) into separate reference files. No external file references are provided. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
355d067
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.