CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

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

The body is an exemplary concise, index-style overview with a clear sequenced workflow and well-signaled one-level-deep references. Its critical defect is that the entire referenced rule library is missing from the bundle, so the progressive-disclosure design cannot actually deliver content, and the workflow lacks an explicit fail-and-retry feedback loop.

Suggestions

Ship the 19 referenced rules/*.md files in the skill bundle (or inline the highest-priority rules) so every link in the rule index resolves — currently all paths like rules/db-performance.md are broken.

Make the verification step unconditional and add a feedback loop, e.g., "Run the narrowest relevant tests; if they fail, fix and re-run before proceeding" instead of running checks only "when the change warrants them".

Add one short worked example showing a concrete change mapped to 2-3 rule files (e.g., a controller with an eager-loading change → db-performance.md + routing.md) to ground the index-based workflow.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: a brief index-style intro ("Best practices for Laravel, organized as an index of rule files"), a six-step application procedure, a rule table, and three decision rules — no padding and no explanation of concepts Claude already knows. Every section earns its place.

5 / 5

Actionability

Concrete, executable instructions ("Verify version-sensitive Laravel APIs for the installed version with `search-docs`", "Run the narrowest relevant tests first, then the project's formatting and static-analysis checks") with specific decision rules ("Keep database access out of Blade views"). No code examples or a worked mapping from a change to rule files, so it falls short of fully copy-paste-ready guidance; per the instruction-only scoring note this is a minor gap, not a disqualifier.

4 / 5

Workflow Clarity

A clearly sequenced six-step process with explicit checkpoints (step 4 API verification, step 6 "Re-read the diff against every mapped rule before finishing"). Falls short of anchor 5 because the test/static-analysis checkpoint is hedged ("when the change warrants them") and there is no error-recovery feedback loop (e.g., fix and re-run on failure); checkpoints are otherwise explicit, keeping it above anchor 3.

4 / 5

Progressive Disclosure

The in-body structure is well organized and the rule index signals one-level-deep references clearly, but scoring against the actual bundle: none of the 19 referenced rules/*.md files (e.g., rules/db-performance.md, rules/validation.md) exist in the skill bundle — every reference path is unresolvable, breaking the disclosure chain. Well-signaled links to nonexistent files leave the reader with structure but no navigable content, which fits anchor 3 better than anchor 4's "minor organization gaps".

3 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, comprehensive, and explicit about both what it covers and when to trigger, with clear Laravel-specific distinctiveness. The only gap is a handful of natural trigger terms (Blade, Artisan, Composer) that users commonly say but that are absent from the description.

DimensionReasoningScore

Specificity

Enumerates many concrete capabilities ("controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries") plus concrete concern triggers ("N+1 and query performance issues, caching strategies, authorization and security patterns"), giving comprehensive coverage with no vague filler. Written in third-person imperative voice, so no voice penalty applies.

5 / 5

Completeness

Explicitly answers both questions: what ("creating or modifying controllers, models, migrations, form requests, policies, jobs...") and when ("Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code", "Also use for Laravel code reviews"). Concrete trigger phrases are present, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("Laravel", "Eloquent", "N+1", "migrations", "code reviews", "refactoring") but a few natural terms users would say are missing — notably "Blade" (covered by the skill body yet absent from the description), "Artisan", and "Composer". Fits anchor 4 (good coverage, a few natural terms missing) better than anchor 5, which requires comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Laravel backend PHP code patterns" carves out a clear niche with framework-specific triggers (Eloquent, form requests, policies) that are unlikely to fire for other skills. Only minimal overlap risk with a generic PHP skill.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 19 missing

Warning

Total

14

/

16

Passed

Repository

laravel/boost

Path

.ai/laravel/skill/laravel-best-practices/SKILL.md

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.