CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration-authentication-user-transforms

Configure portal user transforms: matchers, typed claims, role actions, conditional challenges, MFA, and deny rules. Use for authentication-time policy; stored account rules belong to configuration-users.

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

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 highly actionable, information-dense reference for the transform-user grammar with executable examples, explicit failure semantics, and well-signaled boundaries to sibling skills. The main weaknesses are verbose test-name catalogs and heavy inline detail that would fit better in reference files.

Suggestions

Trim the enumerated internal test identifiers in the 'Unconditional matching' and 'Validation' sections to the few that define behavior boundaries, moving the full test catalog to a reference file.

Move the GitHub identity matcher fine print (canonical uint64 rules, claim derivation details, E2E coverage list) into a references/ file and keep a condensed grammar summary with the four match forms in SKILL.md.

DimensionReasoningScore

Conciseness

Dense expert-level prose that assumes competence (no concept tutorials, precise failure-mode lists, field alias mappings), but the Validation and Unconditional-matching sections enumerate many internal test identifiers of marginal token value that could be trimmed.

4 / 5

Actionability

Provides copy-paste-ready caddyfile blocks covering common cases (GitHub id/org matchers, conditional challenge policies, custom claims, user_org_filters), a concrete grammar spec, source file paths, and explicit parse/validation rules.

5 / 5

Workflow Clarity

As a configuration-grammar skill it has no step sequence, but boundaries and checkpoints are explicit (provisioning failures, shared-validation rejections, 'Inspect go list -m -json before relying on sibling source', and no-fallback failure semantics). It falls short of 5 because validation is presented as documented failure modes rather than an ordered validate-fix-retry flow.

4 / 5

Progressive Disclosure

No bundle files exist, so all content is inline; sections are well-organized and cross-skill links are one level deep with clear load-conditions ('Load those details only when changing the corresponding boundary'). The ~233-line body inlines deep grammar detail (GitHub matcher canonical-ID rules, E2E test catalogs) that could be split into reference files, keeping it below 5.

4 / 5

Total

17

/

20

Passed

Description

87%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 that states concrete capabilities, gives an explicit 'Use for' trigger clause, and carves out boundaries against sibling skills. Minor improvements possible by broadening natural trigger synonyms and using more varied action verbs.

DimensionReasoningScore

Specificity

Enumerates several concrete capabilities ('matchers, typed claims, role actions, conditional challenges, MFA, and deny rules') but uses a single action verb ('Configure') rather than multiple distinct actions, so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

Explicitly answers both: what ('Configure portal user transforms: matchers, typed claims, role actions, conditional challenges, MFA, and deny rules') and when ('Use for authentication-time policy'), with a concrete trigger phrase plus a boundary clause routing stored account rules elsewhere.

5 / 5

Trigger Term Quality

Natural domain phrases like 'authentication-time policy', 'portal user transforms', 'MFA', and 'deny rules' are present, but common user-facing variations (e.g., 'login rules', 'access policy', the 'transform user' directive itself) are missing.

4 / 5

Distinctiveness Conflict Risk

Claims a clear niche (authentication-time policy) and explicitly disambiguates from the closest sibling ('stored account rules belong to configuration-users'), minimizing wrong-skill triggering.

5 / 5

Total

18

/

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-authentication-user-transforms/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.