CtrlK
BlogDocsLog inGet started
Tessl Logo

convert-to-apple-container

Switch from Docker to Apple Container for macOS-native container isolation. Use when the user wants Apple Container instead of Docker, or is setting up on macOS and prefers the native runtime. Triggers on "apple container", "convert to apple container", "switch to apple container", or "use apple container".

70

Quality

88%

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

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.

An excellent, highly actionable runbook: every step is a concrete executable command with expected outputs, the phases are clearly sequenced with hard validation gates and feedback loops, and there is zero padding or concept over-explanation. The only improvements are minor: deduplicate the repeated install instructions and the overlapping changed-files listings.

Suggestions

Conciseness: drop the duplicated Apple Container install instructions from Troubleshooting and instead point back to Prerequisites ("See Prerequisites to install Apple Container"), keeping the troubleshooting entry focused on diagnosing a failed install.

Conciseness: merge the "What this changes" bullet list and the "Summary of Changed Files" table into one listing (the table can carry the per-file detail), removing the redundant parallel enumeration.

Progressive disclosure: consider moving the per-file change detail (Summary of Changed Files table) into a short reference note or collapsing it into the merge-step description, slimming the top-level runbook further.

DimensionReasoningScore

Conciseness

The body is lean and command-first with no explanations of concepts Claude already knows. Minor trimming opportunities exist: the install steps ("Download from https://github.com/apple/container/releases... Install the `.pkg` file... Verify: `container --version`") are repeated verbatim in both Prerequisites and Troubleshooting, and the "What this changes" bullet list overlaps the "Summary of Changed Files" table. This places it at efficient-with-minor-instances-to-trim rather than every-token-earns-its-place.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `git fetch upstream skill/apple-container`, `npm test`, `./container/build.sh`, and concrete `container run` mount tests with expected outputs ("Expected: Read succeeds, write fails with 'Read-only file system'"). The two judgment steps (merge-conflict resolution, WhatsApp verification) are inherently non-scriptable and the concrete commands cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Three clearly sequenced phases with explicit validation checkpoints and feedback loops: a pre-flight idempotency check ("If it already shows `'container'`... Skip to Phase 3"), a hard gate ("All tests must pass and build must be clean before proceeding"), expected-output verification for each mount test, and a Troubleshooting section for error recovery. This matches the anchor for clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The skill ships as a single ~175-line SKILL.md with no bundle files, and the content is well-organized into clear sections (Prerequisites, Phases 1-3, Troubleshooting, Summary table) — appropriate for a self-contained runbook. However, it exceeds the simple-skill case (under 50 lines), and some content is duplicated inline (install steps, changed-files list vs. table) that could be consolidated. Good structure with minor organization gaps rather than an ideal split.

4 / 5

Total

18

/

20

Passed

Description

82%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 that clearly and explicitly states what the skill does and when to use it, with natural trigger phrases and a well-defined niche. Its only weakness is limited specificity of capabilities — it names the single switch action without detailing any of the underlying changes — and slightly incomplete synonym coverage in triggers.

DimensionReasoningScore

Specificity

The description states one concrete action — "Switch from Docker to Apple Container for macOS-native container isolation" — naming the domain and a specific action, but does not enumerate what the switch involves. It matches the anchor for naming the domain with 1-2 concrete actions, not the level above which requires several listed actions.

3 / 5

Completeness

Explicitly answers both: what ("Switch from Docker to Apple Container for macOS-native container isolation") and when ("Use when the user wants Apple Container instead of Docker, or is setting up on macOS and prefers the native runtime") with concrete trigger phrases. This is a clear match for the top anchor.

5 / 5

Trigger Term Quality

Triggers on "apple container", "convert to apple container", "switch to apple container", or "use apple container" — natural phrases a user would say. A few common variations are missing (e.g., plural "apple containers", "apple's container runtime"), so it falls just short of the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — migrating a specific project's runtime to Apple's macOS-native container technology — and its triggers ("apple container", "switch to apple container") plus the qualifier "instead of Docker" keep it distinct from general Docker/container skills. Minimal conflict risk.

5 / 5

Total

17

/

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
jbaruch/nanoclaw-telegram
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.