cluster-onboarding

Interactive onboarding runbook for standing up FoliaNexa's public-facing infrastructure — a VPS edge (WireGuard tunnel, Caddy TLS, portal), its DNS records, and trusting one or more LXD hosts (e.g. 3 machines) into the cluster. Use when the operator says things like "help me set up my VPS", "configure DNS", "onboard my LXD servers", "bootstrap the cluster infra", or wants to walk through CLAUDE.md's Phase 0/3/9 or docs/vps-edge-deployment.md interactively instead of reading the docs cold. Drives real commands on whichever machine the session is running on (VPS, an LXD host, or a jump box with SSH to both), tracks progress across machines/sessions in a small local checklist file, and never invents infrastructure details (domains, IPs, tokens) — always asks.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%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 dense, highly actionable multi-phase runbook with strong sequencing and validation checkpoints for real infrastructure changes. It is mostly lean but carries some trimmable prose and a few long inline sections that a separate reference file could absorb.

Suggestions

Trim conversational asides ('cheaper than guessing', 'say so rather than treating a failed curl as a Caddy bug') to tighten conciseness toward a 5.

Extract the §4.3 placement-labels / --skip-enroll workaround into a references/ file and link to it one level deep, improving progressive_disclosure organization.

Consider hoisting the checklist YAML schema in §0 into a short references/ file so the SKILL.md body stays an overview with clear navigation.

Dimension	Reasoning	Score
Conciseness	Assumes Claude's competence (no explaining what WireGuard/Caddy/LXD are) and stays concrete, but contains minor prose that could be trimmed such as 'cheaper than guessing' and 'say so rather than treating a failed curl as a Caddy bug'.	4 / 5
Actionability	Fully executable, copy-paste-ready commands throughout — 'apt install wireguard-tools caddy', 'deploy/vps/setup-wireguard.sh --role vps', 'caddy validate --config Caddyfile --adapter caddyfile', 'sudo ./tools/folia-host-join.sh --mgmt-url ...' — covering the common per-phase cases.	5 / 5
Workflow Clarity	Clear §0–§5 sequence with explicit validation checkpoints — 'flipping the matching phases.* key once each is verified, not just attempted', 'Don't mark dns_records: true on faith', 'lxc info must succeed', and an end-to-end placement smoke test — plus feedback loops for the two-pass key exchange and enroll fallback.	5 / 5
Progressive Disclosure	No bundle files exist; the runbook is a self-contained, well-organized set of numbered sections with one-level references to repo docs/scripts, though the lengthy §4.3 labels workaround could arguably live in a separate reference.	4 / 5
	Total	18 / 20 Passed

Description

100%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.

The description is specific, complete, and rich in natural trigger phrases, clearly scoping a distinct onboarding niche with minimal conflict risk. It is somewhat long but every clause carries information rather than padding.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'WireGuard tunnel, Caddy TLS, portal', 'its DNS records', 'trusting one or more LXD hosts...into the cluster', 'Drives real commands', 'tracks progress...in a small local checklist file' — with comprehensive coverage of the skill's scope.	5 / 5
Completeness	Explicitly answers both 'what' (interactive onboarding runbook for VPS edge, DNS, and LXD trust) and 'when' ('Use when the operator says things like...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Provides multiple natural trigger phrases an operator would actually say — 'help me set up my VPS', 'configure DNS', 'onboard my LXD servers', 'bootstrap the cluster infra' — plus doc-path triggers, covering synonyms and variations.	5 / 5
Distinctiveness Conflict Risk	Targets a narrow, named niche (FoliaNexa's VPS edge + LXD cluster onboarding) with distinct triggers and specific doc/phase references, so conflict with unrelated skills is minimal.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: kenvandine/FoliaNexa
Path: .claude/skills/cluster-onboarding/SKILL.md
Commit: ea25a68

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.