CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding-directives

Implement or review caddy-security Go code, Caddy modules, parsers, lifecycle, and HTTP delegation. Use for app/plugin boundaries, authcrunch integration, errors, logging, and code conventions.

Quality

88%

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 well-engineered conventions skill: highly actionable with exact identifiers, paths, and test contracts, and exemplary progressive disclosure into two real, purpose-signaled reference files. The main improvement opportunities are tightening the repetitively stated sibling-repository boundary rules and consolidating the implicit multi-step workflows into a single ordered sequence.

DimensionReasoningScore

Conciseness

The body is dense directive prose that assumes competence — it names exact functions (`normalizeSecurityMetadata`, `util.FindReplace`, `cfgutil.EncodeArgs`), exact paths, and exact test names with no basic-concept padding. Minor over-explanation exists (the Repository Scope boundary rules are restated across several paragraphs), keeping it at anchor 4 rather than the uniformly lean anchor 5.

4 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: the parser signature `func parseCaddyfileSurface(d *caddyfile.Dispenser, cfg *authcrunch.Config) error`, specific helpers (`d.RemainingArgs()`, `d.ArgErr()`, `h.Errf`), exact fixture paths (`testdata/caddyfile_adapt/` with `<prefix>.Caddyfile`, expected `<prefix>.json`), named tests (`TestResolveRuntimeAppConfig`, `TestAuthzResponseContract`), and commands (`gofmt`, `make license`). Anchor 5's copy-paste-ready specificity is met via these exact identifiers and contracts.

5 / 5

Workflow Clarity

Sequences are present with most checkpoints: "Before a mutating command, confirm its repository root and working directory, inspect the invoked script's side effects, and resolve its output paths" is an explicit validation gate for risky sibling-repository operations, and the Acceptance criteria section plus the change-based test-selection workflow provide verification endpoints. It falls short of anchor 5 because the workflow is distributed across sections rather than given as one ordered procedure with feedback loops.

4 / 5

Progressive Disclosure

Both bundle references exist and are one level deep, each clearly signaled with a purpose statement and a 'read when' trigger ("read [Runtime lifecycle](references/runtime-lifecycle.md). It traces Caddy's host ordering..." and "[Host plugin contracts](references/host-plugins.md). It defines module naming..."). Detailed material is appropriately split into these files (318 and 389 lines) while the SKILL.md keeps directive-level content, matching anchor 5's clear overview with well-signaled references.

5 / 5

Total

18

/

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: third-person voice, explicit 'Use for' trigger clause, and a precisely scoped technical domain with concrete capability areas. The only weakness is a narrow action-verb set (implement/review) and a few missing natural synonyms such as 'Caddyfile' or 'middleware'.

DimensionReasoningScore

Specificity

"Implement or review caddy-security Go code, Caddy modules, parsers, lifecycle, and HTTP delegation" names the domain precisely and enumerates several concrete technical areas (modules, parsers, lifecycle, HTTP delegation, errors, logging, conventions), though the action verbs are limited to implement/review. This sits above anchor 3 (only 1-2 concrete actions, not comprehensive) but the restricted verb set keeps it below anchor 5's multiple distinct concrete actions.

4 / 5

Completeness

The 'what' is explicit ("Implement or review caddy-security Go code, Caddy modules, parsers, lifecycle, and HTTP delegation") and the 'when' is an explicit "Use for" clause with concrete trigger phrases ("app/plugin boundaries, authcrunch integration, errors, logging, and code conventions"). This clearly matches anchor 5; anchor 4 would require the 'when' to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Triggers like "Caddy modules", "parsers", "lifecycle", "HTTP delegation", "authcrunch integration", "errors, logging, and code conventions" are natural phrasing for users of this codebase. A few natural terms are missing (e.g., "Caddyfile", "directives", "middleware"), matching anchor 4 (good keyword coverage, a few natural terms missing) rather than anchor 5's synonym/extension completeness.

4 / 5

Distinctiveness Conflict Risk

"caddy-security" plus "Caddy modules, parsers, lifecycle" carves out a clear coding-directives niche distinct from sibling configuration/testing skills, with minimal conflict risk. It is not the anchor-4 case of overlapping broadly related skills — the repo-scoped triggers are unambiguous.

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

greenpau/caddy-security

Path

.codex/skills/coding-directives/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.