CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

payload

Use when working with Payload projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.

67

Quality

84%

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

86%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.

An exemplary reference skill: executable code with correct/incorrect contrast, Payload-specific defaults that go beyond common knowledge, and a clean one-level-deep reference architecture. The only notable improvement is de-duplicating guidance repeated across Security Pitfalls, Common Gotchas, and Best Practices.

DimensionReasoningScore

Conciseness

The body is dense with Payload-specific knowledge Claude genuinely lacks (slugField, _status, overrideAccess, autoGenerate) and code blocks earn their tokens, but the Local API access-control warning appears three times (Security Pitfalls, Common Gotchas, Best Practices) and the drafts/_status guidance is repeated across five sections — minor trimming candidates consistent with anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Copy-paste-ready executable TypeScript throughout: full buildConfig, slugField() usage, ❌/✅ overrideAccess pairs, req-threading for transactions, and getPayload() in both route handlers and Server Components, covering the common cases — fully matches anchor 5.

5 / 5

Workflow Clarity

Quick Start (create-payload-app → pnpm dev) and the build/type-generation decision guidance are clearly sequenced, and the collection-vs-field hook decision rule is explicit; however, the transaction and hook-loop patterns lack validate→fix→retry checkpoints, so it sits at anchor 4 rather than 5. It is not capped at 3 since the skill is reference/pattern-oriented rather than a destructive batch procedure.

4 / 5

Progressive Disclosure

A 28-row Quick Reference table maps each task to an anchored link in a topic file, per-section pointers ("For all field types... see FIELDS.md") keep detail one level deep, and a Reference Documentation section indexes all 11 topic files — clear overview with well-signaled one-level references, matching anchor 5. No bundle files were present in the review directory, so this is scored on the body's reference structure.

5 / 5

Total

18

/

20

Passed

Description

78%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, well-targeted description with explicit dual "Use when" triggers, concrete domain artifacts, and high distinctiveness. Its main weakness is that the 'what' is implied by context enumeration rather than stated as concrete actions the skill performs.

DimensionReasoningScore

Specificity

Quotes "payload.config.ts, collections, fields, hooks, access control, Payload API" and "debugging validation errors, security issues, relationship queries, transactions" — many concrete domain-specific items, but they describe contexts ("working with", "debugging") rather than actions the skill performs, so minor coverage gaps remain versus the comprehensive anchor 5.

4 / 5

Completeness

Two explicit "Use when..." clauses give a strong, specific 'when', and the parenthetical scope list supplies a 'what', but the what is only implied ("working with Payload projects") rather than an explicit statement of what the skill does — above anchor 3 (where 'when' would be missing or weakly implied), below anchor 5.

4 / 5

Trigger Term Quality

Strong natural vocabulary ("Payload projects", "payload.config.ts", "validation errors", "relationship queries", "hook behavior") that users would actually say, including a distinct filename artifact; missing common synonyms like "CMS", "admin panel", or "Next.js CMS" keeps it below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Payload projects" and "payload.config.ts" name a clear niche with near-unique triggers; no closely related skill would claim these terms, so conflict risk is minimal — matches anchor 5 exactly.

5 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (519 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 46 missing

Warning

Total

14

/

16

Passed

Repository

whimzyLive/nightshift-ai

Path

.agents/skills/payload/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.