CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuration-messaging

Configure email, file and SQLite messaging providers, bounded delivery workers, SMTP transport, sender credentials and registration notifications.

Quality

74%

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-messaging/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly informative, project-specific reference with copy-paste configuration examples and unusually explicit validation boundaries and gotchas (Bcc/RCPT TO behavior, STARTTLS limitations, lease semantics). Its weaknesses are the inlining of deep SQLite runtime detail that belongs in a reference file, an unsequenced workflow, and verification guidance that names tools but never gives a concrete command.

Suggestions

Move the SQLite outbox runtime/worker semantics (leases, budgets, cleanup ordering, crash behavior) into a references/ file and keep a concise overview plus the config example in SKILL.md.

Add a concrete, pinned command or script for the disposable loopback SMTP test server so the verification workflow is executable end to end.

Present the configure -> wire -> verify flow as an explicit numbered sequence so the validation checkpoints are unambiguous.

DimensionReasoningScore

Conciseness

The body is dense with project-specific, non-obvious facts ('File providers... do not use credentials or passwordless', 'timeout defaults to 1s and accepts 1ms through 30s') and does not explain concepts Claude already knows. It falls short of 5 because the SQLite outbox section uses long compound sentences that could be tightened, and is above 3 because there is essentially no padding.

4 / 5

Actionability

Four complete, copy-paste-ready Caddyfile blocks (email, file, SQLite outbox, registration wiring) cover the common configuration cases, with exact instruction names, defaults, and limits. It is not 5 because the verification guidance ('use an explicitly configured loopback test server', 'pin its version') gives no concrete command or tool to execute.

4 / 5

Workflow Clarity

A clear implicit sequence (choose provider type, write the block, wire registration, verify) is paired with explicit validation boundaries ('This verifies rendered content, not SMTP authentication, TLS or recipient delivery'; 'File output checks alone do not verify SMTP authentication, TLS or recipients'). Not 5 because the steps are never presented as an explicit sequence and the adapt-testcase pointers are not runnable instructions; not 3 because validation checkpoints are explicitly stated.

4 / 5

Progressive Disclosure

The body has good section structure and one-level, clearly signaled cross-links to sibling skills, but roughly 90 lines of SQLite runtime and worker semantics (lease durations, crash duplication, cleanup ordering, quarantine handling) are inlined in a 230-line SKILL.md with no references/ split. This matches anchor 3 (content that should be separate is inline) better than 4, while the organization present keeps it above 2.

3 / 5

Total

15

/

20

Passed

Description

66%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, distinctive description that clearly names the domain objects it configures, with good natural keyword coverage. Its main weakness is the total absence of any 'when to use' trigger clause, which caps completeness and limits discovery in ambiguous situations.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when configuring Caddyfile security messaging blocks, SMTP/file/SQLite notification providers, or registration email delivery.'

Include common synonyms and variations users might say, such as 'outbox', 'mail', or 'notifications', to broaden natural triggering.

Clarify the Caddy/security context ('Caddyfile security app messaging providers') to further sharpen distinctiveness against generic email-sending skills.

DimensionReasoningScore

Specificity

The description enumerates several concrete capability areas ('email, file and SQLite messaging providers, bounded delivery workers, SMTP transport, sender credentials and registration notifications') with only minor gaps (e.g., templates, verification). It sits between anchor 3 (1-2 concrete actions) and 5 (multiple distinct actions), since a single verb 'Configure' governs many specific targets — noticeably above the midpoint.

4 / 5

Completeness

The 'what' is clear (configure providers, workers, transport, credentials, notifications) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Natural, user-sayable keywords are present ('email', 'SMTP', 'SQLite', 'messaging provider', 'registration notifications'), giving good coverage. It is not 5 because common variations such as 'outbox', 'mail', or plain 'notifications' are missing, and not 3 because coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Caddy-security messaging provider configuration) with distinct, specific terms, so it is mostly distinct. It is not 5 because 'sender credentials' creates minor overlap with the sibling configuration-credentials skill, and not 3 because the domain is tightly scoped and unlikely to trigger unrelated skills.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

greenpau/caddy-security

Path

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