CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-practices

Audit, review, and harden Better Auth integrations. Use when the user wants Better Auth security review, config debugging, provider hardening, session checks, or operational risk guidance.

Quality

72%

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 ./Skills/security-ops/best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-sectioned but generic process contract: it sequences an evidence-first review workflow with fail-fast validation, yet contains almost no Better Auth-specific or executable detail. Its referenced progressive-disclosure paths are dangling relative to the actual bundle, which breaks navigation to the deferred material.

Suggestions

Replace abstract directives with executable specifics: name the actual surfaces to inspect (e.g., auth.ts config, provider setup, session cookie options) and give at least one real validator command (e.g., npx @better-auth/cli generate or a concrete config-check step) in the Validation section.

Fix the Progressive Disclosure section to reference files that exist in the skill's bundle (or inline the essential guidance); the current Infrastructure/references/... and deferred-skill-context/ paths resolve to nothing in this skill's directory.

Merge the redundant scope/deferral guidance spread across Philosophy, Execution Boundaries, Gotchas, and Anti-Patterns into one section to cut repeated boilerplate and tighten the token budget.

DimensionReasoningScore

Conciseness

The body avoids concept-explaining padding and uses terse bullets, but the same ideas (bounded scope, deferred references, evidence-first) are restated across Philosophy, Execution Boundaries, Gotchas, and Anti-Patterns, so it could be meaningfully tightened.

3 / 5

Actionability

There is no concrete executable guidance anywhere in the body: "Inspect 2-3 focused surfaces" never names which surfaces, "Run the narrowest real validator or command path available" names no actual command, and no config keys, file paths, or example findings appear — only high-level process hints.

2 / 5

Workflow Clarity

The numbered 5-step workflow has a clear sequence with validation checkpoints ("Stop at the first failed gate", "Rerun the relevant validation after fixes") and a fix-then-rerun feedback loop in Failure Mode, but the steps are abstract process language rather than command-anchored checkpoints.

4 / 5

Progressive Disclosure

The Progressive Disclosure section points to Infrastructure/references/openai-cookbook-expert-lens-pack.md, software-literature lens/map files, and Infrastructure/references/deferred-skill-context/security-ops-best-practices/, but none of these paths exist in the actual bundle (references/ contains only eval-harness files), so the navigation is broken even though the sectioning itself is well organized.

2 / 5

Total

11

/

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, well-formed description: it clearly states what the skill does and when to use it, with concrete Better Auth-specific trigger phrases and minimal conflict risk. Its only weakness is mild redundancy in the action verbs and some missing natural trigger variations.

DimensionReasoningScore

Specificity

The description lists several domain-anchored actions ("Audit, review, and harden Better Auth integrations") with sub-capabilities enumerated in the when-clause, but "audit" and "review" are near-synonymous and no concrete outputs (findings, remediations) are named, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both what ("Audit, review, and harden Better Auth integrations") and when ("Use when the user wants Better Auth security review, config debugging, provider hardening, session checks, or operational risk guidance") with concrete trigger phrases, matching the anchor-5 pattern.

5 / 5

Trigger Term Quality

"Better Auth security review, config debugging, provider hardening, session checks, operational risk guidance" gives good natural keyword coverage, but common user phrasings like "check my auth setup", "is my auth config secure", or "auth audit" are missing, so it falls short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description names a specific framework (Better Auth) with a clear niche and distinct triggers (security review, provider hardening, session checks), so it is unlikely to fire for unrelated skills.

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Skills/security-ops/best-practices/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.