CtrlK
BlogDocsLog inGet started
Tessl Logo

configuration-oauth-providers

Configure external OAuth/OIDC login providers, credentials, scopes, issuer/audience trust, JWKS, PKCE, and portal enablement. Named relying-party registrations and portal OPs belong to OAuth applications.

63

Quality

79%

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-providers/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, code-grounded configuration skill: executable examples, per-driver requirements, parser-compatibility caveats, and an explicit review checklist make it highly actionable with little wasted explanation. Weaknesses are a long narrative body that could be tightened and references to bundle/asset paths (e.g. assets/config/home.Caddyfile) that are not present in the evaluated bundle.

Suggestions

Either include `assets/config/home.Caddyfile` in the bundle or remove/soften the three references to it so every cited path is resolvable.

Tighten the narrative sections ("GitHub identity claims", "Provider-Side Claim Notes") into terse bullet contracts to reduce body length without losing the code-backed constraints.

Add a short troubleshooting/validation loop (e.g. what to inspect when provider registration or login fails) to complement the Review Checklist and complete the workflow checkpoints.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, repo-specific facts (driver scope defaults, parser quirks, per-provider required fields) and does not re-explain OAuth concepts Claude already knows. It is not a 5 because the ~300-line body has sections ("GitHub identity claims", "Provider-Side Claim Notes") written as narrative documentation that could be tightened or trimmed.

4 / 5

Actionability

Guidance is copy-paste ready: complete Caddyfile blocks for azure/github plus the portal wiring, the shortcut form, exact field names, accepted toggle syntax, per-driver required fields, and a review checklist with concrete constraints. The common cases are covered by executable examples, matching the top anchor.

5 / 5

Workflow Clarity

The structure gives a usable sequence (shape → required fields per driver → common options → portal enablement) and the "Review Checklist" section is an explicit validation checkpoint with code-backed constraints. It falls short of 5 because there is no error-recovery/feedback loop (e.g. what to check when login fails or validation rejects a directive), leaving minor checkpoint gaps.

4 / 5

Progressive Disclosure

The single bundle reference `references/shared-parser.md` exists, is one level deep, and is clearly signaled with conditional loading guidance ("Read ... when changing OAuth directives, issuer/audience, keys, or parser validation"). Not a 5 because the body references files not present in this bundle (`assets/config/home.Caddyfile` is cited three times but no `assets/` directory exists, and two sibling-skill paths are unverifiable here), and some of the long options detail could live in the reference.

4 / 5

Total

17

/

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-scoped description with strong natural trigger terms and an explicit ownership boundary that reduces conflict risk with sibling skills. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness at 3 per the rubric guidelines.

Suggestions

Add an explicit trigger clause, e.g. "Use when configuring `oauth identity provider <name>` blocks in a Caddyfile, or when the user mentions OAuth/OIDC login, external identity providers, or portal provider enablement."

Add one or two natural synonyms such as "identity provider" or "sign-in with <provider>" to broaden trigger coverage beyond the current OAuth/OIDC vocabulary.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capabilities — "Configure external OAuth/OIDC login providers, credentials, scopes, issuer/audience trust, JWKS, PKCE, and portal enablement" — with specific objects for each. It falls short of a 5 because nearly everything hangs on the single verb "Configure", so the action coverage is narrower than the multi-verb anchor example.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance; the second sentence ("Named relying-party registrations and portal OPs belong to OAuth applications") is a routing boundary, only weakly implying when to use the skill. Per the judging guideline, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "OAuth", "OIDC", "login providers", "credentials", "scopes", "portal". Coverage is good but a few natural variants are missing (e.g. "identity provider", "sign-in", "SSO"), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (external OAuth/OIDC login providers for a Caddyfile-based auth stack) and the second sentence explicitly disambiguates ownership of "named relying-party registrations and portal OPs", minimizing conflict with sibling skills. Not 4 because the boundary sentence makes overlap risk minimal, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

16

/

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: 2 suspicious

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository
greenpau/caddy-security
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.