CtrlK
BlogDocsLog inGet started
Tessl Logo

laravel-best-practices

Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries. Triggers for N+1 and query performance issues, caching strategies, authorization and security patterns, validation, error handling, queue and job configuration, route definitions, and architectural decisions. Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices. Covers any task involving Laravel backend PHP code patterns.

88

1.13x
Quality

Does it follow best practices?

Impact

100%

1.13x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, information-dense best-practice catalog that assumes Laravel competence and names specific APIs, but it provides no executable code examples and its 'How to Apply' workflow lacks validation checkpoints. Most critically, the 19 referenced rules/*.md files do not exist in the bundle, breaking the progressive-disclosure path the skill relies on.

Suggestions

Ship the referenced rule files (rules/db-performance.md, rules/security.md, etc.) or remove the '→ rules/*.md' pointers and the 'use a sub-agent to read rule files' instruction so the skill is self-contained.

Add at least one executable code snippet per major section, or keep the deferral but make it explicit that the body is a pattern checklist and the rules files hold syntax/examples.

Add a validation/verification checkpoint to the migration and queue workflows (e.g., test the down() rollback, verify retry_after > timeout) since these involve destructive or batch operations.

DimensionReasoningScore

Conciseness

Quotes 'Eager load with `with()` to prevent N+1 queries' and 'retry_after must exceed job timeout; use exponential backoff [1, 5, 10]' show lean, dense rules that assume Laravel competence with no concept-padding. Matches the score-3 anchor; not a 2 because there is no unnecessary explanation or fluff to tighten — every bullet is a concrete best practice.

3 / 3

Actionability

Quotes name concrete APIs ('`with()`', '`Cache::remember()`', '`ShouldBeUnique`', '`php artisan make:migration`', '`constrained()`'), but there are no complete executable code blocks and the body defers syntax ('For exact API syntax, verify with `search-docs`'). Matches score 2 (concrete guidance but incomplete, missing key details); not 3 because nothing is copy-paste ready, not 1 because real specific APIs are named rather than vague direction.

2 / 3

Workflow Clarity

Quotes '1. Identify the file type and select relevant sections', '2. Check sibling files for existing patterns', '3. Verify API syntax with `search-docs`' give a present sequence, but there are no validation checkpoints despite destructive/batch operations in scope (migrations: 'Never modify migrations that have run in production'). Matches score 2 (steps listed but validation gaps, checkpoints implicit); not 3 because no feedback loops, not 1 because a clear 3-step sequence exists.

2 / 3

Progressive Disclosure

Quotes '### 1. Database Performance → `rules/db-performance.md`' (repeated across 19 sections) and 'Always use a sub-agent to read rule files' show well-signaled one-level-deep references, but the referenced `rules/*.md` files are absent from the bundle (no rules/, references/, scripts/, or assets/ directories exist), so navigation leads nowhere and the overview carries all real content. Matches score 2 (some structure, references present but content that should be separate is effectively inline); not 3 because the detail files are missing and disclosure is broken, not 1 because it is not a monolithic wall and references are one level deep and clearly labeled.

2 / 3

Total

9

/

12

Passed

Description

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.

The description is excellent: it explicitly states both what the skill does and when to apply it, enumerates many concrete Laravel actions, and uses natural trigger terms within a clearly distinct Laravel niche. Voice is appropriately imperative/third-person with no first- or second-person violations.

DimensionReasoningScore

Specificity

Quotes 'writing, reviewing, or refactoring Laravel PHP code' and 'creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries' list multiple specific concrete actions, matching the score-3 anchor. It is not a 2 because the action enumeration is comprehensive rather than naming only the domain and a few actions.

3 / 3

Completeness

Quotes 'Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code' and 'Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices' provide explicit when-triggers, while the enumerated components answer what. Clearly answers both what AND when with explicit triggers, matching score 3; not a 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

Quotes 'N+1 and query performance issues', 'caching strategies', 'authorization and security patterns', 'validation, error handling, queue and job configuration, route definitions', and 'Laravel code reviews' give good coverage of natural terms a Laravel developer would actually say. Not a 2 because common variations across many Laravel domains are present rather than a few scattered keywords.

3 / 3

Distinctiveness Conflict Risk

Quotes 'Laravel PHP code', 'Eloquent queries', and 'form requests, policies, jobs, scheduled commands' establish a clear Laravel-specific niche with distinct triggers unlikely to fire for non-Laravel skills. Not a 2 because the heavy framework-specific terminology sharply distinguishes it from generic PHP or code-review skills.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
laravel/boost
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.