CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

proxmox-service-guest-gate

Plan, inspect, approve, create, validate, and roll back a fresh Proxmox service guest while protecting legacy guests. Use before creating or changing an LXC or VM for self-hosted services, especially on resource-constrained Proxmox hosts.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 presents a well-sequenced, change-gated workflow with strong validation checkpoints, rollback safety conditions, and lean procedural guidance — its workflow clarity is exemplary. The main defects are the missing `templates/guest-change-request.md` bundle file referenced twice (a broken reference that undermines the confirmation-record step) and the absence of any concrete command examples for the inventory and creation steps.

Suggestions

Add the missing `templates/guest-change-request.md` bundle file (or remove both references to it), since the "Required confirmation record" and "Bundled resources" sections point users to a template that does not exist in the bundle.

Include one or two concrete command examples for the read-only inventory step (e.g., `pct list`, `pvesm status`) or state explicitly where to find them, to raise actionability from mostly-executable to fully executable.

Tighten the opening paragraph — "Use this skill to prevent a self-hosting plan from becoming an unreviewed Proxmox change. It separates read-only inventory from state-changing creation, makes guest parameters explicit, and preserves legacy guests..." restates the description and could be reduced to a single purpose-plus-delegation line.

DimensionReasoningScore

Conciseness

No padding with concepts Claude already knows (no "what is Proxmox/LXC" exposition); the body is dense procedural guidance. Minor trimmable spots remain — the opening sentence "Use this skill to prevent a self-hosting plan from becoming an unreviewed Proxmox change. It separates read-only inventory from state-changing creation..." partly restates the description, and "Treat the suggested sizing as an assumption until the current node inventory is confirmed" is wordy. Not the every-token-earns-its-place lean of anchor 5, but well above the noticeably-verbose anchors.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: step 3 enumerates exact proposal parameters ("guest type, ID, hostname, CPU, RAM, swap, root disk, data disk, storage pool, network bridge, address strategy, runtime features, autostart behavior, service scope, data paths, backup boundary, and rollback condition") and the confirmation record lists exact table fields. Minor gap: no command examples (`pct`, `qm`, `pvesm`) anywhere, partly mitigated by delegation to the `proxmox-ve-operations` skill — per the scoring notes, absent code is not penalized when the guidance itself is actionable, keeping this above anchor 3.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints: the step-5 confirmation gate ("show the exact state-changing request... Obtain explicit confirmation"), step-7 validate-before-data, and rollback preconditions ("Destroy only the newly created disposable guest after confirming it contains no user data"). A checklist-style confirmation table is required before creation. This matches anchor 5's explicit validation plus error-recovery rollback; the destructive-operation cap does not apply because validation is pervasive.

5 / 5

Progressive Disclosure

Scored against the actual bundle: `references/guest-validation.md` exists, is one level deep, and is well signaled ("Read references/guest-validation.md for the read-only, creation, validation, and rollback gates"). However, `templates/guest-change-request.md` is referenced twice — in "Required confirmation record" and "Bundled resources" — but does not exist in the bundle (no `templates/` directory at all). A broken reference to the skill's key confirmation artifact is more than the "minor organization gaps" of anchor 4, placing this at anchor 3.

3 / 5

Total

16

/

20

Passed

Description

88%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: it names concrete lifecycle actions in the Proxmox domain, gives an explicit 'Use before...' trigger clause, and stays in third person without fluff. The only weaknesses are slightly incomplete natural-synonym coverage (no "container"/"CT") and mild overlap risk with a general Proxmox operations skill on the broad "changing an LXC or VM" trigger.

DimensionReasoningScore

Specificity

"Plan, inspect, approve, create, validate, and roll back a fresh Proxmox service guest while protecting legacy guests" lists six concrete lifecycle actions in a specific domain, comprehensively covering the workflow. Anchor 4 would require minor gaps in coverage, but the verbs span the entire plan-to-rollback lifecycle.

5 / 5

Completeness

Explicitly answers both: what ("Plan, inspect, approve, create, validate, and roll back a fresh Proxmox service guest") and when ("Use before creating or changing an LXC or VM for self-hosted services, especially on resource-constrained Proxmox hosts"). Matches the anchor-5 example structure with concrete trigger phrases; anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural terms present: "Proxmox", "LXC", "VM", "self-hosted services", "resource-constrained Proxmox hosts" — the words a user provisioning a guest would actually say. Missing common synonyms such as "container"/"CT" and bare "guest setup", so not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (creation-gating of a fresh service guest on Proxmox) with domain-specific triggers, but "creating or changing an LXC or VM" could also fire for a general Proxmox operations skill — the body itself references a sibling `proxmox-ve-operations` skill covering adjacent ground. Minor overlap risk with a closely related skill, which is the anchor-4 condition rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

pvnkmnk/AgenticSelfHostSkills

Path

skills/proxmox-service-guest-gate/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.