CtrlK
BlogDocsLog inGet started
Tessl Logo

hermes-s6-container-supervision

Modify, debug, or extend the s6-overlay supervision tree inside the Hermes Agent Docker image — adding new services, debugging profile gateways, understanding the Architecture B main-program pattern.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/devops/hermes-s6-container-supervision/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is lean, highly actionable, and well-sequenced with explicit validation checkpoints and strong error-recovery guidance; its only structural weakness is that it is a single monolithic file with no progressive disclosure into detail reference files.

DimensionReasoningScore

Conciseness

The body is dense and project-specific — it assumes Claude knows Docker/s6 basics, never pads with generic explanations, and every section (architecture diagram, key-files table, recipes, pitfalls) carries unique operational detail that earns its tokens.

3 / 3

Actionability

Recipes give fully executable `docker exec` commands with absolute paths and decoded expected outputs, and "Add a new static service" is a copy-paste-ready numbered list with exact file paths and contents — matching the executable-and-complete anchor.

3 / 3

Workflow Clarity

Multi-step recipes (e.g. adding a static service) are clearly sequenced, the test harness recipe states an explicit checkpoint ("Expect 19 passed, 0 xfailed"), and a dedicated Common Pitfalls section provides error-recovery feedback loops for crash loops, perm errors, and exit 143.

3 / 3

Progressive Disclosure

Sections are well-organized with clear headers and a key-files table, but the skill is monolithic — no bundle files exist and everything (recipes, pitfalls, architecture rationale) is inline rather than split into one-level-deep reference files, so the well-signaled-references anchor for 3 is not met.

2 / 3

Total

11

/

12

Passed

Description

67%

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 and well-scoped to a distinct niche, but it lacks an explicit usage-trigger clause and mixes natural domain terms with internal jargon, leaving the "when to use" dimension only implied.

Suggestions

Add an explicit trigger clause, e.g. "Use when adding or removing s6 services, debugging a profile gateway that won't start or survive docker restart, or modifying cont-init.d boot scripts in the Hermes Docker image."

Replace the internal "understanding the Architecture B main-program pattern" phrasing with user-facing terms like "understanding why the container CMD routes args through main-wrapper.sh".

Include a couple of natural keyword variations users might actually say (e.g. "s6 service", "docker restart", "gateway crash loop") to improve trigger coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Modify, debug, or extend", "adding new services", "debugging profile gateways", "understanding the Architecture B main-program pattern" — matching the anchor for enumerating several specific actions rather than a single vague one.

3 / 3

Completeness

It clearly states what the skill does but never gives an explicit "Use when..." trigger clause; the "when" is only implied from the action list, so per the guideline it caps at 2.

2 / 3

Trigger Term Quality

It contains relevant domain keywords (s6-overlay, supervision tree, Docker image, profile gateways, services) but leans on internal jargon ("Architecture B main-program pattern") that a user would rarely say, missing common natural variations.

2 / 3

Distinctiveness Conflict Risk

The niche is sharply scoped to the Hermes Agent Docker image's s6-overlay supervision tree, making it highly distinguishable and very unlikely to trigger for the wrong skill.

3 / 3

Total

10

/

12

Passed

Validation

75%

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

Validation12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository
NousResearch/hermes-agent
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.