CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration-oauth-applications

Register named OAuth clients, manage private registration storage, and configure portal OIDC providers. Owns security oauth/oidc provisioning commands; external login providers and security local are separate.

Quality

77%

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-oauth-applications/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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, repo-specific specification: complete grammar, exact validation limits, named commands and tests make it directly executable. Weaknesses are repetition across sections that inflates token cost and inline detail (parser edge cases, exhaustive test lists) that belongs in the well-organized reference files.

Suggestions

Consolidate the repeated brace/NextSegment and redirect_uri-arity rules into one section; Grammar and Ownership currently restate each other.

Move the parser edge-case detail (quoted braces, RemainingArgs behavior) and the exhaustive test-enumeration list into a reference file, keeping SKILL.md to ownership, grammar, and workflows.

Link oidc-conformance-actions.md directly from SKILL.md so every bundle file is reachable one level deep.

DimensionReasoningScore

Conciseness

The body is dense with genuinely project-specific rules (no generic concept explanations), but at 241 lines it restates several constraints across sections (brace/NextSegment handling in Ownership and again in Grammar; redirect_uri singular arity in Grammar, "Why One Callback per Statement", and Credentials) and includes rationale prose that could be tightened or moved to references. It sits between anchor 3 (mostly efficient, could be tightened) and anchor 4.

3 / 5

Actionability

The complete copy-paste-ready Caddyfile grammar block enumerates every field with allowed values, plus exact constraints (32–1024 byte secrets, 2048–8192-bit moduli, 1–64 ASCII revisions), named commands (`security oauth rotate secret`), serialization keys, a complete example fixture path, and named tests per behavior. Guidance is fully executable and covers the common cases; anchor 4's 'minor gaps' do not apply.

5 / 5

Workflow Clarity

The credential-change workflow is explicitly sequenced ("First stage any credential change with `security oauth rotate secret`, then select that revision") with fail-closed validation checkpoints (mismatched/corrupt/nonprivate records fail, digest rejects mid-flight changes). Not anchor 5 because the document is primarily a spec — the rotation/validation sequencing is embedded in prose rather than presented as an explicit ordered checklist with retry loops.

4 / 5

Progressive Disclosure

Three of the four reference files (oidc-provider.md, oidc-conformance.md, private-provisioning.md) are well-signaled one-level-deep with content summaries; oidc-conformance-actions.md is only reachable two levels deep via oidc-conformance.md, and dense parser edge-case/test-enumeration detail is inlined in SKILL.md that could live in references. Good structure with minor organization gaps — anchor 4, not 5.

4 / 5

Total

16

/

20

Passed

Description

70%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, well-bounded description with concrete domain actions and excellent sibling-skill disambiguation. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness and leaves activation guidance implicit.

Suggestions

Add an explicit trigger clause, e.g. "Use when configuring oauth application blocks, registering or rotating OAuth client credentials, or setting up portal OIDC providers in security."

Include common synonyms such as "OpenID Connect" and "client registration" to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

"Register named OAuth clients, manage private registration storage, and configure portal OIDC providers" names the domain and three concrete actions. It stops short of anchor 5's comprehensive coverage because adjacent capabilities (secret rotation, callback/PKCE validation) are only implied by the body, not the description.

4 / 5

Completeness

The 'what' is clear (register clients, manage registration storage, configure portal OIDC providers), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the second sentence is a boundary statement, not usage triggers. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "OAuth", "OIDC", "clients", "providers", "registration", "provisioning". A few natural variants are missing (e.g. "OpenID Connect" spelled out, "client registration"), keeping it below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Owns security oauth/oidc provisioning commands; external login providers and security local are separate" explicitly carves the niche and disambiguates adjacent skills. Combined with narrow domain-specific terms, conflict risk is minimal; no neighboring anchor fits better.

5 / 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: 7 suspicious

Warning

Total

15

/

16

Passed

Repository

greenpau/caddy-security

Path

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