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.

59

Quality

49%

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, 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'

DimensionReasoningScore

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)

DimensionReasoningScore

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.

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.