CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

akka-net-management

Akka.Management for cluster bootstrapping, service discovery (Kubernetes, Azure, Config), health checks, and dynamic cluster formation without static seed nodes.

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/akka-management/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 well-structured, actionable reference for Akka.Management configuration with genuinely useful troubleshooting and decision tables. The dominant defect is broken progressive disclosure: the two reference files the body depends on for discovery-provider code and the settings model are missing from the bundle, which also degrades actionability of the main configuration path.

Suggestions

Ship discovery-providers.md and configuration-reference.md in the skill bundle (or inline the essential ConfigureDiscovery implementation and AkkaSettings class), since ConfigureAkkaManagement calls into content that currently exists nowhere.

Consolidate the duplicated decision guidance — merge the 'Why Use Akka.Management?' pros/cons table into the final 'Summary: When to Use What' table — and consider trimming the 25-line ASCII diagram.

Present the setup as an explicit ordered workflow (packages → remoting → management/bootstrap → discovery → health checks) with verification checkpoints, e.g. confirming the /ready endpoint returns 200 before declaring the cluster formed.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its tokens: executable C#, package lists, endpoint tables, and troubleshooting checklists with little explanation of concepts Claude already knows. It falls short of 5 due to trimmable material — the 25-line ASCII architecture diagram, and decision guidance duplicated between the 'Why Use Akka.Management?' pros/cons table and the 'Summary: When to Use What' table.

4 / 5

Actionability

Concrete, near copy-paste-ready guidance: exact NuGet PackageReferences, real Akka.Hosting APIs (WithAkkaManagement, WithClusterBootstrap, WithActorSystemLivenessCheck), specific option assignments (FilterOnFallbackPort, StableMargin, RequiredContactPointsNr), and an Aspire endpoint snippet. It is not a 5 because ConfigureDiscovery and the AkkaSettings/AkkaExecutionMode types are used but never defined in the bundle — the files containing them are missing — leaving a gap in the main setup path.

4 / 5

Workflow Clarity

A coherent implicit sequence (install packages → configure remoting/management → configure discovery → wire health checks) is reinforced by symptom-based troubleshooting checklists ('Cluster Won't Form', 'Split Brain') that function as validation and error-recovery loops. It is not a 5 because the setup steps are never presented as an explicit ordered workflow with checkpoints to verify progress before moving on.

4 / 5

Progressive Disclosure

Structure and signaling are good — a dedicated 'Reference Files' section plus inline pointers, one level deep — but both referenced files (discovery-providers.md, configuration-reference.md) are absent from the bundle, so navigation dead-ends and the promised discovery-provider setup code and configuration model classes are simply missing. It scores above 2 because the body itself is well-sectioned and not monolithic, but the broken reference targets are more than the 'minor organization gaps' of a 4.

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, domain-focused description that clearly communicates what the skill covers, with strong natural trigger terms for cluster deployment scenarios. Its main weaknesses are the missing explicit 'Use when...' trigger clause and some synonym gaps (e.g., 'Akka.NET', liveness/readiness terminology).

Suggestions

Append an explicit trigger clause, e.g. 'Use when deploying or configuring Akka.NET clusters on Kubernetes, Azure, or Aspire, when replacing static seed nodes, or when setting up cluster health checks.'

Add missing natural synonyms users would say: 'Akka.NET', '.NET', 'liveness/readiness probes', and 'seed nodes' (currently only appears as 'static seed nodes').

State capabilities as actions in third person (e.g., 'Configures cluster bootstrap..., exposes health endpoints...') to sharpen specificity.

DimensionReasoningScore

Specificity

The description enumerates several concrete capabilities — 'cluster bootstrapping, service discovery (Kubernetes, Azure, Config), health checks, and dynamic cluster formation without static seed nodes' — naming the concrete discovery providers. It falls short of a 5 because capabilities are listed as noun phrases rather than actions, and coverage gaps exist (e.g., no mention of liveness/readiness endpoints or Akka.Hosting integration).

4 / 5

Completeness

The 'what' is clear (management HTTP endpoints, bootstrap, discovery, health checks), but there is no 'Use when...' clause or equivalent explicit trigger guidance; per the judging guidelines, a missing 'Use when' clause caps completeness at 3. It is not a 2 because the 'what' is concrete and multi-faceted rather than vague.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'Akka.Management', 'cluster bootstrapping', 'service discovery', 'Kubernetes', 'Azure', 'health checks', 'static seed nodes' — terms a user deploying an Akka.NET cluster would plausibly say. A few natural variations are missing, such as 'Akka.NET', '.NET', 'seed node configuration', or 'liveness/readiness probes', so it does not reach the comprehensive-with-synonyms level of a 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Akka.Management specifically, with named providers Kubernetes/Azure/Config) makes wrong-skill triggering unlikely. It is not a 5 because it overlaps with closely related Akka.NET sibling skills — the body itself cross-references an 'akka-net-aspire-configuration' skill, and a general Akka clustering skill would share triggers like 'cluster', 'seed nodes', and 'Kubernetes'.

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: 4 missing

Warning

Total

15

/

16

Passed

Repository

Aaronontheweb/dotnet-skills

Path

skills/akka-management/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.