CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration-secrets

Configure security.secrets plugins and secret lookup values for users, credentials, and crypto. Use for SQLite/Consul provisioning, static/AWS wiring, and lookup failures; runtime field support belongs to runtime resolution.

Quality

86%

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.

This is a high-quality, deeply actionable skill body: every section carries concrete Caddyfile syntax, exact commands, error strings, and non-obvious repo-specific constraints, with real reference files used appropriately for the two optional managers. The main improvement opportunities are tightening the test-fixture/validation detail and making the per-manager split between inline content and reference files consistent.

DimensionReasoningScore

Conciseness

The body is dense with repo-specific facts Claude would not know (module import paths, exact error strings like "secret value is not a string", fixture expectations) and assumes competence rather than explaining Caddy or secrets concepts. It is not score 5 because sections like "Validation Notes" and "Fixtures" run long on test-internals detail that could be trimmed or pushed to a reference; it is clearly above score 3, which requires noticeably unnecessary explanation.

4 / 5

Actionability

Guidance is fully executable throughout: complete Caddyfile blocks for each manager shape, copy-paste authdbctl commands ("authdbctl generate password hash --cost 10 --password SomeFunkyPassword"), exact lookup syntax "secrets:<secret_id>:<key>", and concrete failure modes with their literal error messages. Examples cover the common cases (static users, AWS region/path, bcrypt hashing, API keys).

5 / 5

Workflow Clarity

The sections sequence a coherent configuration flow (shape → per-manager setup → lookup wiring → hash generation → validation/fixtures), and validation checkpoints are substantively addressed (strict three-field resolution, missing-manager/key provisioning failures, fixture error expectations, reload/recovery behavior). It misses score 5 because steps are not explicitly enumerated with validate-and-retry loops — checkpoints are described narratively rather than as an ordered procedure with feedback cycles.

4 / 5

Progressive Disclosure

The bundle structure is used well: both references/consul.md and references/sqlite.md exist and are clearly signaled one level deep ("use the [Consul secrets reference](references/consul.md)"), with the runtime-resolution boundary delegated to a sibling skill. It falls short of score 5 because the static and AWS manager sections plus the ~45 lines of test-fixture notes are fully inlined in SKILL.md, an organization inconsistency against the pattern established by the SQLite/Consul references.

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: it states concrete capabilities in third person, gives explicit 'Use for' triggers covering the four supported managers plus failure debugging, and cleanly scopes itself against the runtime-resolution skill. The only weakness is that a few natural trigger terms covered by the body (secret manager, password/API key hashes) are missing from the description itself.

DimensionReasoningScore

Specificity

"Configure security.secrets plugins and secret lookup values for users, credentials, and crypto" names the domain and concrete actions, and "SQLite/Consul provisioning, static/AWS wiring, and lookup failures" enumerates specific scenarios and manager types. It stops short of score 5 because coverage has minor gaps (e.g., generated hash values and validation behavior appear in the body but not the description), and is well above score 3's '1-2 concrete actions' bar.

4 / 5

Completeness

Both halves are explicit: the 'what' is "Configure security.secrets plugins and secret lookup values for users, credentials, and crypto" and the 'when' is "Use for SQLite/Consul provisioning, static/AWS wiring, and lookup failures" with concrete trigger phrases. It even adds a boundary clause ("runtime field support belongs to runtime resolution"), which the score-4 anchor lacks in explicitness.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say in this niche are present: "SQLite/Consul provisioning", "static/AWS wiring", "lookup failures", "credentials". It falls short of score 5's comprehensive synonym coverage — variants like "secret manager", "password hash", or "bcrypt" that the body covers are absent from the description.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Caddy/authcrunch security.secrets plugin configuration) with distinct triggers, and the boundary clause "runtime field support belongs to runtime resolution" explicitly disambiguates it from the closely related runtime-resolution skill. Minimal conflict risk, matching the score-5 anchor.

5 / 5

Total

18

/

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

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository

greenpau/caddy-security

Path

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