CtrlK
BlogDocsLog inGet started
Tessl Logo

php-guidelines-from-spatie

Describes PHP and Laravel guidelines provided by Spatie. These rules result in more maintainable, and readable code.

53

Quality

42%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/php-guidelines-from-spatie/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

10

/

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.