CtrlK
BlogDocsLog inGet started
Tessl Logo

testcontainers-guide-migrator

Migrate a Testcontainers guide from testcontainers.com into the Docker docs site (docs.docker.com). Converts AsciiDoc to Hugo Markdown, updates code to the latest Testcontainers API, splits into chapters with stepper navigation, verifies code compiles and tests pass, and validates against Docker docs style rules. Use when asked to migrate a testcontainers guide, add a TC guide, or port content from testcontainers.com to Docker docs.

72

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

A highly actionable, well-sequenced migration workflow with strong validation feedback loops and concrete executable commands for five languages. Its main weaknesses are repetitive per-language test-command blocks that could be parameterized and large inline reference data that would benefit from being split into bundle files.

Suggestions

Collapse the five near-identical Step 6 `docker run` test-command blocks into one parameterized template (image, install step, test command) plus a small per-language exceptions table covering the Java docker-java.properties/spotless and Go gcc/musl cases.

Move the 21-guide inventory table into a `references/guide-inventory.md` (or similar) bundle file and reference it from SKILL.md, keeping only the already-migrated notes and input-resolution guidance inline.

Extract the per-language latest-API migration patterns (Step 4) into a `references/api-updates.md` file so SKILL.md stays a lean overview pointing one level deep to the detailed patterns.

DimensionReasoningScore

Conciseness

The body is mostly efficient and assumes Claude's competence (no 'what is AsciiDoc' padding), but the five near-identical language test-command blocks in Step 6 share one structure and could be tightened into a single parameterized template plus a small per-language exceptions table.

2 / 3

Actionability

Provides copy-paste-ready, executable guidance throughout — a git clone command, an AsciiDoc→Markdown conversion table, per-language API migration patterns, concrete `docker run` test commands, frontmatter templates, and an exact commit message format.

3 / 3

Workflow Clarity

Steps 0–9 are clearly sequenced with explicit validation feedback loops: Step 6 verifies the original compiles, updates code, and runs tests with 'fix until green', and Step 8 re-runs `docker buildx bake vale` until no errors remain before committing.

3 / 3

Progressive Disclosure

The file is a well-organized 393-line monolith with no bundle files (no references/scripts/assets dirs); the 21-guide inventory table and the per-language test-command blocks are substantial inline content that could be split into separate reference files rather than carried in SKILL.md.

2 / 3

Total

10

/

12

Passed

Description

100%

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, third-person description that names several concrete actions and pairs them with an explicit 'Use when' trigger covering natural phrasings. It is distinctive and complete on both the 'what' and 'when' axes.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person — 'Converts AsciiDoc to Hugo Markdown, updates code to the latest Testcontainers API, splits into chapters with stepper navigation, verifies code compiles and tests pass, and validates against Docker docs style rules' — matching the top anchor.

3 / 3

Completeness

Explicitly answers both what (the list of conversion/update/verify/validate actions) and when ('Use when asked to migrate a testcontainers guide...'), satisfying the top anchor.

3 / 3

Trigger Term Quality

The 'Use when asked to migrate a testcontainers guide, add a TC guide, or port content from testcontainers.com to Docker docs' clause uses natural phrases a user would actually say, with good coverage of variations.

3 / 3

Distinctiveness Conflict Risk

The niche is narrow and specific — migrating Testcontainers guides from testcontainers.com to the Docker docs Hugo site — making it unlikely to trigger for unrelated skills.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository
docker/docs
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.