CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration-authorization

Configure authorization policies, ACLs, static claims enrichment, required external decisions, bypasses, identity headers, JWT verification, remote Basic/API-key auth, SQLite API keys, and direct OAuth without a portal.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/configuration-authorization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A strong, dense configuration reference with executable examples throughout, explicit defaults, and well-organized one-level-deep references that all exist in the bundle. The main improvement opportunities are tightening the longest behavioral sections and moving the deepest edge-case detail into the reference layer.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious domain facts (default cookie names, redirect statuses, rejected settings) and never explains concepts Claude already knows like JWT or OAuth. It falls short of level 5 because the redirect-URL preservation and path-decoding sections run long and discursive where a tighter statement or a pointer to the owning tests would do.

4 / 5

Actionability

Copy-paste-ready caddyfile blocks cover policy shape, ACL shortcuts and explicit rules, set-options, bypass rules, inject headers, and Basic/API-key wiring, plus concrete curl commands with real headers. Defaults and rejected inputs are enumerated specifically, matching the fully-executable anchor with common cases covered.

5 / 5

Workflow Clarity

Content flows from a minimal working shape through defaults, ACL grammar, policy options, and auth modes to test fixtures, and the Acceptance criteria section provides explicit validation checkpoints ('Verify response behavior and downstream call counts, not just returned errors'). It is not a 5 because guidance is organized by topic rather than as a sequenced configure-then-validate procedure with explicit feedback loops.

4 / 5

Progressive Disclosure

All five references/ files exist and each is well-signaled with a purpose statement and explicit ownership ('That reference owns private offline issuance and revocation'), one level deep. It is not a 5 because the ~430-line body inlines multi-paragraph deep-dives (path-encoding rules, redirect URL preservation) that are handled at the same depth of detail as content split into the reference files.

4 / 5

Total

17

/

20

Passed

Description

71%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 specific, comprehensive capability list that clearly describes what the skill configures, with strong domain-specific keywords. Its main weakness is the complete absence of a 'when to use' trigger clause, which both caps completeness and slightly weakens trigger discoverability.

Suggestions

Append an explicit trigger clause such as 'Use when configuring authorization policy blocks, authorize route handlers, or ACL rules in a security app' so completeness can reach level 4-5.

Add one or two natural synonyms in the trigger clause (e.g. 'access control' alongside 'authorization', 'authz' alongside 'ACL') to broaden trigger-term coverage.

Clarify the boundary with sibling skills, e.g. 'for JWT key material itself, use configuration-crypto' to reduce overlap risk on 'JWT verification'.

DimensionReasoningScore

Specificity

The description lists ten-plus concrete configuration targets ("authorization policies, ACLs, static claims enrichment, required external decisions, bypasses, identity headers, JWT verification, remote Basic/API-key auth, SQLite API keys, and direct OAuth") covering every major section of the skill. This matches the anchor for multiple specific concrete actions with comprehensive coverage, exceeding the level-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

The 'what' is clear and detailed, but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete and comprehensive rather than vague.

3 / 5

Trigger Term Quality

Keywords like "authorization policies", "ACLs", "JWT verification", "Basic/API-key auth", and "OAuth" are natural terms for users of this configuration domain, giving good coverage. It falls short of level 5 because no synonyms or variations are included (e.g. 'access control', 'authz').

4 / 5

Distinctiveness Conflict Risk

Distinctive items like "static claims enrichment", "SQLite API keys", and "direct OAuth without a portal" carve a clear niche, but "JWT verification" overlaps a sibling crypto-configuration skill and the authorization/authentication boundary is close to other portal skills, matching the 'mostly distinct; minor overlap risk with closely related skills' anchor.

4 / 5

Total

16

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 suspicious

Warning

Total

15

/

16

Passed

Repository

greenpau/caddy-security

Path

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