CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

elixir-pro

Create and review idiomatic Elixir code with OTP patterns, supervision trees, and Phoenix LiveView. Use when building or debugging Elixir services that need reliable concurrency and fault tolerance.

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 ./Skills/agent-ops/elixir-pro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 organized and terse at the section level, with a reasonable procedure and validation loop, but it under-delivers on its own promise: only one small code example for a code-quality skill, generic boilerplate sections that add tokens without Elixir-specific value, and a broken reference path. Fixing the reference path and swapping template filler for concrete OTP examples would raise it substantially.

Suggestions

Correct the reference path from 'Infrastructure/references/deep-guidance.md' to 'references/deep-guidance.md' so the pointer resolves against the actual bundle.

Replace or Elixir-ify the generic Philosophy/Constraints/Anti-patterns boilerplate, and either complete the Table of Contents or drop it for a document this short.

Add one or two executable examples covering the skill's core claims (e.g., a minimal GenServer child spec or supervisor setup) so the OTP guidance is concrete rather than descriptive.

DimensionReasoningScore

Conciseness

Individual sections are terse, but the body carries generic template filler Claude already knows — 'Optimize for clear, verifiable outcomes with the minimum necessary changes', 'Redact secrets, tokens, credentials' — plus a Table of Contents for a short document. This is more than the 'minor instances of over-explanation' of anchor 4, but the body is not severely padded either, so it sits at anchor 3.

3 / 5

Actionability

One executable, complete code example exists (PortParser.parse/1), but the core OTP guidance — 'Model long-lived state with GenServer', 'Let supervisors restart failed workers' — has no concrete code, command, or module skeleton. Guidance is real but incomplete relative to the skill's stated scope, matching anchor 3 rather than anchor 4's 'concrete code or commands with minor gaps'.

3 / 5

Workflow Clarity

The Procedure section gives a clear 3-step sequence (confirm scope → focused changes → re-run validations) and the Validation section adds explicit checkpoints ('Fail fast: stop at the first blocking validation failure', 'Re-run checks after fixes'), i.e., a feedback loop. The gap keeping it below anchor 5 is that validations are named abstractly ('highest-signal validations', 'relevant local checks') with no concrete commands.

4 / 5

Progressive Disclosure

The deep-guidance reference is well-signaled with a read-when condition, but the path given is wrong: the body says 'Infrastructure/references/deep-guidance.md' while the actual bundle file is 'references/deep-guidance.md' — following the written path fails. The Table of Contents also omits roughly half the body's sections (Philosophy, Procedure, Validation, Constraints, Anti-patterns, References). These are more than 'minor organization gaps' of anchor 4, but structure and signaling intent are present, placing it above anchor 2.

3 / 5

Total

13

/

20

Passed

Description

82%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 with a clear niche, explicit 'Use when...' trigger guidance, and good natural keyword coverage. Its only weakness is limited action coverage — 'create and review' are the sole verbs, leaving the capability list narrower than the domain it names.

Suggestions

Expand the action list beyond 'Create and review' (e.g., 'design supervision trees, debug process crashes, review GenServer usage') to lift specificity toward comprehensive coverage.

Add one or two natural synonyms or file cues users might mention, such as 'mix', '.ex/.exs', or 'Erlang/BEAM', to broaden trigger matching.

DimensionReasoningScore

Specificity

The description names the domain ('idiomatic Elixir code with OTP patterns, supervision trees, and Phoenix LiveView') and exactly two concrete actions — 'Create and review' — matching the anchor for 1-2 concrete actions but not comprehensive. It does not list several distinct actions (no debugging-specific actions, no review dimensions), so it falls below anchor 4.

3 / 5

Completeness

It clearly answers both questions: 'what' is 'Create and review idiomatic Elixir code with OTP patterns, supervision trees, and Phoenix LiveView' and 'when' is the explicit trigger clause 'Use when building or debugging Elixir services that need reliable concurrency and fault tolerance', with concrete trigger phrases. Not the lower anchor 4, since the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Elixir', 'OTP', 'supervision trees', 'Phoenix LiveView', 'debugging', 'concurrency', 'fault tolerance' — terms users would naturally say. A few natural terms are missing (e.g., 'mix', '.ex', 'Erlang', 'BEAM'), so it does not reach comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Elixir/OTP/Phoenix LiveView) with distinct, unambiguous triggers ('building or debugging Elixir services'); minimal risk of triggering for the wrong skill. Not lower anchors, which require overlap with generic or closely-related skills.

5 / 5

Total

17

/

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/agent-ops/elixir-pro/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.