CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oauth-implementation

OAuth 2.0 and OpenID Connect authentication with secure flows. Use for third-party integrations, SSO systems, token-based API access, or encountering authorization code flow, PKCE, token refresh, scope management errors.

Quality

85%

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.

A tight, well-structured skill body: efficient tables and code instead of prose, a correctly split one-level-deep reference bundle, and a clearly sequenced authorization flow with state validation. The remaining gaps are in executable completeness — an undefined provider constant, a placeholder where session creation belongs, and no error handling around the token exchange.

DimensionReasoningScore

Conciseness

The body is lean: a flow-selection table, two focused code blocks, terse security checklists, and a pointer to the reference file. No padding, no explanation of concepts Claude already knows (no 'what is OAuth' prose, no library tutorials). This matches the anchor-5 'lean and efficient; every token earns its place' profile; the only candidate for trimming — the one-line intro restating the description — is negligible.

5 / 5

Actionability

The Express authorization-code flow and PKCE generator are real, largely copy-paste-ready JavaScript with correct parameter construction and state validation. Not anchor 5 because of concrete gaps: the callback ends in a placeholder comment ("// Store tokens securely and create session"), `PROVIDER_URL` is never defined, the imported `jwt` is unused, and the token exchange has no error handling for a failed `tokenResponse`. Above anchor 3 because the code is genuinely executable rather than pseudocode.

4 / 5

Workflow Clarity

The flow table routes the user to the right mechanism, and Step 1/Step 2 sequence the authorization-code flow with an explicit state-validation checkpoint ("if (req.query.state !== req.session.oauthState)"). Not anchor 5 because there is no validation or error-recovery loop after the token exchange — a failed or malformed token response is unhandled. Not capped at 3: auth implementation is not a destructive or batch operation. Anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') is the best fit.

4 / 5

Progressive Disclosure

SKILL.md serves as a clear overview (core flows and security rules) with a well-signaled, one-level-deep reference: "See [references/python-java.md](references/python-java.md) for:" followed by a bullet list of exactly what it contains. The reference file exists, matches those bullets, and contains no further nested references. The split is appropriate — main JS flow inline, Python/Java/OIDC-provider details external — matching the anchor-5 example structure.

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 well-structured description with an explicit and richly enumerated trigger clause, answering both 'what' and 'when' clearly. Its main weakness is that the capability statement itself is topic-based rather than action-based, and a couple of broad triggers could overlap with adjacent auth-related skills.

Suggestions

Replace the generic "authentication with secure flows" with concrete action verbs, e.g. "Implement OAuth 2.0 and OpenID Connect flows (authorization code, PKCE, client credentials), configure token refresh and scope management, and integrate third-party SSO providers".

Add missing natural trigger phrases users actually say, such as "social login", "sign in with Google/GitHub", or simply working with "OAuth" or "OIDC".

Narrow the broad triggers ("third-party integrations", "token-based API access") to OAuth-specific contexts, e.g. "third-party OAuth providers" and "OAuth token-based API access", to reduce overlap with generic API-integration skills.

DimensionReasoningScore

Specificity

The description names the domain ("OAuth 2.0 and OpenID Connect") and concrete specifics ("authorization code flow, PKCE, token refresh, scope management"), but the leading capability statement "authentication with secure flows" is generic — there is no concrete action verb like 'implement', 'configure', or 'integrate'. This matches anchor 3 (names domain and 1-2 concrete actions, not comprehensive); it is above anchor 2 because the flow/scope terms are specific, and below anchor 4 because the actual actions to perform are never stated, only topics are enumerated.

3 / 5

Completeness

Both questions are answered explicitly: what ("OAuth 2.0 and OpenID Connect authentication with secure flows") and when ("Use for third-party integrations, SSO systems, token-based API access, or encountering authorization code flow, PKCE, token refresh, scope management errors"). This mirrors the anchor-5 example structure — clear what followed by an explicit, concrete 'Use when' clause with multiple trigger phrases.

5 / 5

Trigger Term Quality

Good natural trigger coverage: "third-party integrations", "SSO systems", "token-based API access", "token refresh", "scope management" — phrases a user would plausibly say. Not anchor 5 because common variations like "login", "sign-in with...", "social login", or simply "OAuth"/"OIDC" as standalone user utterances are absent; above anchor 3 because multiple synonyms across integration scenarios are present.

4 / 5

Distinctiveness Conflict Risk

Terms like "authorization code flow", "PKCE", and "scope management" form a clear niche with minimal conflict risk. Below anchor 5 because "third-party integrations" and "token-based API access" are broad enough to overlap with generic API-integration or JWT/API-key skills; above anchor 3 because the OAuth-specific triggers dominate the description.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

secondsky/claude-skills

Path

plugins/oauth-implementation/skills/oauth-implementation/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.