Skill Crossroads — akka-net-best-practices

Skill Crossroads akka-net-best-practices
rubric v1.2 · deterministic

overall

Correctness & Structure 67 1 fail

Triggering & Discoverability 85 1 warn

Clarity & Instructions 100 pass

Token & Context Cost 91 1 warn

Safety & Security 89 1 warn

Verifiability & Maintainability 53 1 fail

Top fixes — ranked by score impact

✗ STRUCT-05 Supporting-file references resolve

SKILL.md:23references `work-distribution-patterns.md` → no such file or directory in the skill

Reference to `work-distribution-patterns.md` does not resolve to a file in the skill directory.

work-distribution-patterns.md

SKILL.md:24references `cluster-local-abstractions.md` → no such file or directory in the skill

Reference to `cluster-local-abstractions.md` does not resolve to a file in the skill directory.

cluster-local-abstractions.md

SKILL.md:25references `async-cancellation-patterns.md` → no such file or directory in the skill

Reference to `async-cancellation-patterns.md` does not resolve to a file in the skill directory.

async-cancellation-patterns.md

SKILL.md:258references `work-distribution-patterns.md` → no such file or directory in the skill

Reference to `work-distribution-patterns.md` does not resolve to a file in the skill directory.

work-distribution-patterns.md

SKILL.md:326references `cluster-local-abstractions.md` → no such file or directory in the skill

Reference to `cluster-local-abstractions.md` does not resolve to a file in the skill directory.

cluster-local-abstractions.md

SKILL.md:383references `async-cancellation-patterns.md` → no such file or directory in the skill

Reference to `async-cancellation-patterns.md` does not resolve to a file in the skill directory.

async-cancellation-patterns.md

Fix Add the missing file(s), fix the path, or remove the dead reference.

✗ VERIFY-01 Evals or tests present

SKILL.md:1the skill works → no evals/, tests/, or verification section found

No way to prove the skill does what it claims.

Fix Add an evals/ folder (test prompts + expected outcomes) and a '## Verify' step in the body.

⚠ SAFETY-03 No destructive auto-invocation

SKILL.md:39auto-invocable (no disable-model-invocation) → performs a destructive action ("Publish")

Skill appears to "Publish" but the model can auto-invoke it — a destructive action could fire without the user asking.

Publish

Fix If this action is destructive/irreversible, set `disable-model-invocation: true` so it only runs when explicitly invoked.

⚠ TRIGGER-03 Invocation cues in the description

SKILL.md:1description will match user requests → no explicit cue ('use when …', 'triggers on …', quoted user phrases) found

Pure what-it-does prose — the model has to guess when to invoke it.

Critical Akka.NET best practices including EventStream vs DistributedPubSub, …

Fix State the trigger explicitly: 'Use when the user says "…", "…", or wants to …'.

⚠ TOKEN-02 Progressive disclosure

SKILL.mdeverything inlined in SKILL.md → 380 body lines, 0 supporting files

Large SKILL.md (380 lines) with no supporting files — all of it loads every time the skill fires.

Fix Move heavy reference material into supporting files and link to them, so the model loads it only when needed.

★ scores higher than ≈9% of 208 public skills (deterministic rubric v1.2 sample, 2026-09)

Embed this badge

Always-fresh — it re-scans and updates on its own.

[![Skill Crossroads](https://skillcrossroads.com/api/badge/ComeOnOliver/skillshub/skills/Aaronontheweb/dotnet-skills/akka-best-practices.svg)](https://skillcrossroads.com/s/ComeOnOliver/skillshub/skills/Aaronontheweb/dotnet-skills/akka-best-practices)

Grade your own Claude Code skill — evidence-cited, file-and-line, free. Scan your own skill →