CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration

Build or review caddy-security Caddyfiles and select focused configuration skills. Use for security app declarations and authenticate/authorize route wiring.

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.

This is a strong router-style skill: lean, parser-anchored, with a complete runnable example and verified one-level-deep references. The main gaps are the absence of an explicit error-recovery loop in the workflow and a few abstract governance sentences that could be trimmed.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence throughout — no padding or explanations of known concepts — though a few abstract policy sentences ('Keep recognized-but-restricted forms visible with their validation status') could be tightened. Not 5 because the Syntax Currency and Acceptance criteria sections carry some prose that reads more like governance than directly usable instruction.

4 / 5

Actionability

The Common Shape section provides a complete, copy-paste-ready Caddyfile covering the common case (local identity store, portal crypto, policy, and route wiring), plus optional matcher forms, concrete parser filenames (caddyfile.go, plugin_authn.go), and exact fixture paths. Not below 5: no pseudocode or fragments are presented as runnable examples — fragments are explicitly labeled with their enclosing scope.

5 / 5

Workflow Clarity

The Workflow section gives a clear 5-step sequence with a validation checkpoint (step 5: check generated syntax against local wrappers, upstream grammar, validators, and fixtures). Not 5 because there is no in-body feedback loop for what to do when that check fails — error recovery is delegated to the linked testing contract skill; not 3 because the validation checkpoint itself is explicit.

4 / 5

Progressive Disclosure

A well-executed router pattern: the body stays an overview, three reference files (syntax-maintenance.md, authcrunch-compatibility.md, operator-examples.md) exist in the bundle, are one level deep, and each is signaled with an explicit when-to-use condition. The Domain Map appropriately routes to sibling domain skills rather than inlining their grammar, keeping navigation easy.

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 concise, third-person description with explicit what-and-when structure and a clearly distinct niche. The trigger coverage is thinner than the skill's actual scope, omitting the provider and identity-store vocabulary users are likely to use.

Suggestions

Add natural trigger synonyms for the major routed domains, e.g. 'Use for security app declarations, OAuth/OIDC or SAML provider setup, identity stores, and authenticate/authorize route wiring.'

Widen the 'what' beyond build/review to match the body's actual scope (e.g. configuring portals, policies, and identity providers in caddy-security Caddyfiles).

DimensionReasoningScore

Specificity

'Build or review caddy-security Caddyfiles and select focused configuration skills' names the domain plus several concrete actions (build, review, select, 'authenticate/authorize route wiring'). Not 5 because coverage stops short of naming the other major configuration surfaces (identity stores, crypto, OAuth/SAML providers) that the body actually routes.

4 / 5

Completeness

Both parts are explicit: the 'what' ('Build or review caddy-security Caddyfiles') and an equivalent 'Use for...' trigger clause naming two wiring scenarios. Not 5 because the when-clause is terse relative to the anchor's concrete multi-phrase triggers and omits the review/audit contexts the body clearly supports.

4 / 5

Trigger Term Quality

'caddy-security Caddyfiles', 'security app declarations', and 'authenticate/authorize route wiring' are natural terms a Caddy user would say. Not 5 because common synonyms users would actually invoke — OAuth/OIDC, SAML, SSO, identity provider, secrets — are absent.

4 / 5

Distinctiveness Conflict Risk

'caddy-security Caddyfiles' is a clear niche with distinct, plugin-specific triggers; virtually no overlap risk with generic configuration skills. Neighboring anchor 4 ('minor overlap risk') fits less well since no other skill would claim these triggers.

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

relative_links

Relative link issues: 21 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

greenpau/caddy-security

Path

.codex/skills/configuration/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.