Describes PHP and Laravel guidelines provided by Spatie. These rules result in more maintainable, and readable code.
53
42%
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 — it merely states it 'describes guidelines' without specifying concrete actions or when Claude should select it. The inclusion of 'PHP', 'Laravel', and 'Spatie' provides some domain anchoring, but the lack of specific capabilities and explicit trigger conditions makes it weak for skill selection among many options.
Suggestions
Add a 'Use when...' clause with explicit triggers, e.g., 'Use when writing PHP or Laravel code, when the user asks about Spatie conventions, coding standards, or best practices for Laravel projects.'
Replace 'Describes PHP and Laravel guidelines' with specific actions, e.g., 'Applies Spatie's PHP and Laravel coding conventions including class design, routing patterns, naming conventions, and code formatting.'
Include natural trigger terms users would say, such as 'code style', 'best practices', 'coding standards', 'clean code', 'refactor', or specific Spatie package names.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'guidelines' and 'rules' without listing any concrete actions. It doesn't specify what the skill actually does beyond 'describes guidelines' — no mention of specific coding patterns, conventions, or actionable capabilities. | 1 / 3 |
Completeness | The 'what' is weak (just 'describes guidelines') and there is no 'when' clause or explicit trigger guidance at all. The absence of a 'Use when...' clause caps this at 2 per the rubric, but the 'what' is also too vague, bringing it to 1. | 1 / 3 |
Trigger Term Quality | It includes some relevant keywords like 'PHP', 'Laravel', and 'Spatie' that users might naturally mention. However, it misses common variations like 'coding standards', 'code style', 'best practices', 'linting', or specific Laravel concepts. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Spatie' adds some distinctiveness, and 'PHP and Laravel' narrows the domain. However, it could easily overlap with other PHP/Laravel coding skills since 'guidelines' and 'readable code' are very broad descriptors. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a reasonably well-structured coding conventions skill with good coverage of PHP/Laravel standards and some strong code examples, particularly for control flow and docblocks. Its main weaknesses are redundancy across sections (especially the Quick Reference duplicating earlier content), several incomplete sections that state rules without providing the promised examples, and a monolithic structure that could benefit from splitting into overview + reference files.
Suggestions
Remove the Quick Reference / Code Quality Reminders section or consolidate it as the primary source of truth to eliminate redundancy with earlier sections
Add concrete code examples for incomplete sections: Class Structure (constructor promotion example), Strings (interpolation vs concatenation), Enums (PascalCase example), and Translations (__() usage)
Consider splitting detailed reference content (docblock rules, naming conventions, file structure) into a separate REFERENCE.md and keeping SKILL.md as a concise overview with links
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but has some redundancy — several rules are stated in multiple sections (e.g., typed properties over docblocks appears in 'Type Declarations & Docblocks', 'Class Structure', and 'Code Quality Reminders'; split compound if conditions and avoid else are repeated). The Quick Reference section largely duplicates earlier content. Some sections like Comments include explanatory prose that could be tighter. | 2 / 3 |
Actionability | Many sections provide concrete code examples (control flow, docblocks, validation, artisan commands), but several sections merely state rules without examples (Class Structure says 'use constructor property promotion' with no code, Strings says 'string interpolation over concatenation' with no example, Enums says 'PascalCase' with no example, Translations just says 'use __() function'). These incomplete sections reduce overall actionability. | 2 / 3 |
Workflow Clarity | This is a coding style/convention skill rather than a multi-step workflow skill. The single-purpose nature (follow these conventions when writing PHP/Laravel code) is unambiguous, and the content is organized into clear categorical sections that are easy to follow sequentially. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear section headers, but it's a long monolithic document (~250 lines) that could benefit from splitting detailed sections (e.g., docblock rules, naming conventions) into separate reference files. There are no cross-references to external files, and the Quick Reference section at the end duplicates earlier content rather than serving as a concise entry point. | 2 / 3 |
Total | 9 / 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 | |
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.