CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

iii-engine-config

Configure a managed iii engine through worker-compose.yaml or a directly supervised engine through config.yaml. Use for engine ports, RBAC via the rbac-proxy worker, observer limits, streams, sandboxes, and configuration storage.

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

78%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 highly actionable, information-dense skill: complete YAML and CLI examples for both engine modes, concrete error codes, and real operational guidance. Its weaknesses are structural rather than substantive — reference-grade material (observers defaults, metrics, RBAC schema) is inlined in a single 185-line file with no bundle files, and version-sensitive notes are not quarantined in a versions/deprecated section.

Suggestions

Split reference-grade material into one-level-deep bundle files (e.g., references/observers.md with the full defaults table and metrics list, references/rbac.md with the RBAC settings schema and observer-RBAC rules), keeping SKILL.md as a mode-selection overview with short examples and clearly signaled links.

Add an explicit change → restart → verify sequence for configuration changes (edit file, restart Compose/engine, then confirm with compose::status / engine::workers::list), including recovery steps when startup fails with UNSUPPORTED_CONFIG_WORKERS.

Move version-sensitive statements ("Since 0.25 the engine reads...", "(0.25 engine)") into a dedicated versions/compatibility note so time-sensitive facts do not age the core instructions.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no space is spent explaining YAML, WebSockets, or systemd — and every section carries iii-specific facts (e.g., "engine.url defaults to ws://127.0.0.1:49134", "compose::add never edits engine: or restarts the engine"). It falls short of the lean 5 anchor because version-number references ("Since 0.25 the engine reads...", "(0.25 engine)") and a few trimmable asides ("Check the rbac-proxy worker's docs for the version that forwards the observe messages") are not isolated in a deprecation/versions section.

4 / 5

Actionability

Both configuration modes have complete, copy-paste-ready YAML blocks and exact CLI invocations ("iii compose --namespace orders-daemon --up --file worker-compose.yaml", "iii trigger -n orders-daemon compose::add worker=rbac-proxy", "iii --config config.yaml"), plus concrete error codes (UNSUPPORTED_CONFIG_WORKERS, LIMIT_EXCEEDED, FORBIDDEN), named metrics, and the full observers defaults block. This fully covers the common cases with executable material, matching the top anchor.

5 / 5

Workflow Clarity

The two modes are clearly separated, each with its own start command, and operational verification is provided ("Use compose::status for process ownership and engine::workers::list for live connections", "Use iii ps to find iii processes... and iii kill --orphans"). It is not a 5 because there is no explicit ordered change → restart → verify sequence, and validation around risky operations (engine restart, iii kill) is listed as tools rather than explicit checkpoints with recovery steps.

4 / 5

Progressive Disclosure

Section headers (Managed Compose engine, Observers, RBAC, Directly supervised engine, Security and operations, When to Use, Boundaries) are clear and navigation is easy, but the skill is ~185 lines with no bundle files at all: the full observers defaults table, the metric name reference, and the multi-paragraph RBAC schema details are sizable reference material inlined in SKILL.md that belong in one-level-deep reference files. This matches the 'content that should be separate is inline' anchor rather than the good-but-minor-gaps anchor at 4.

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, specific description: it names both configuration modes with their exact files and provides an explicit trigger list covering ports, RBAC, observers, streams, sandboxes, and storage. Written in third person, concise, and free of fluff. Minor room to add a few more natural synonyms (supervisor, restart, engine setup) for trigger coverage.

DimensionReasoningScore

Specificity

"Configure a managed iii engine through worker-compose.yaml or a directly supervised engine through config.yaml" names concrete actions tied to specific artifacts, and "engine ports, RBAC via the rbac-proxy worker, observer limits, streams, sandboxes, and configuration storage" covers the domain comprehensively. This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor which expects minor gaps.

5 / 5

Completeness

The 'what' is explicit (configure a managed engine via worker-compose.yaml or a supervised engine via config.yaml) and the 'when' is an explicit "Use for" clause listing concrete triggers: engine ports, RBAC via the rbac-proxy worker, observer limits, streams, sandboxes, and configuration storage. Both are clearly and explicitly answered with concrete trigger phrases, matching the top anchor; the 'missing Use when clause' cap of 3 does not apply.

5 / 5

Trigger Term Quality

Terms like "engine ports", "RBAC", "rbac-proxy", "worker-compose.yaml", "config.yaml", "observer limits", "streams", and "sandboxes" are the natural vocabulary an iii user would say. It falls short of the 5 anchor because a few natural phrasings users might use (e.g., "engine setup", "supervisor", "restart the engine", "systemd/Kubernetes") are absent, but it is well above the 3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche (iii engine configuration, two named config files, rbac-proxy) is distinct and unlikely to trigger generic skills, matching 'mostly distinct; minor overlap risk'. It is not a 5 because topics like streams, sandboxes, and observers border on sibling iii skills (e.g., iii-observe) whose docs cover the code-level side, creating minor overlap risk.

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

iii-hq/iii

Path

skills/iii-engine-config/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.