CtrlK
BlogDocsLog inGet started
Tessl Logo

msk-migration

Use this skill to assess and plan a migration from AWS MSK (Managed Streaming for Apache Kafka) to Confluent Cloud. Triggers on user intent like "migrate MSK to Confluent Cloud", "move off MSK", "MSK to CC cutover", "Zero-Cut migration from MSK", "kcp scan my MSK", or any discussion of MSK-to-CC assessment, planning, cluster sizing, Cluster Linking setup, Gateway-based switchover, or post-cutover validation. Do NOT trigger for non-MSK Kafka sources (open-source Kafka, Aiven, Confluent Platform, Redpanda) — this skill is MSK-only. Do NOT trigger for greenfield Confluent Cloud projects with no existing Kafka source. Do NOT trigger for general Kafka programming questions (producer/consumer code, Kafka Streams) unrelated to migration.

66

Quality

83%

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

68%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 is a well-structured, highly actionable migration skill: it routes concrete KCP commands, maps exact live-fetch URLs, and sequences stages with validation invariants. Its main weakness is conciseness — recurring repetition of the KCP intro and the .md/.html citation rule across sections — and some decision-logic bulk that could live in references.

Suggestions

Consolidate the recurring KCP first-mention intro into a single defined phrasing and reference it by name from Scope, Mode Detection, Intake Path Selection, and Invariants instead of restating it each time.

Move the long 'Full URLs in citation link text' rule and the .md-vs-.html fetch/cite mechanics into a single Sources of Truth subsection, deleting the duplicate exposition in Skill Conduct.

Consider relocating the large Cross-Stage Decision Logic tables (cluster-type hard limits, auth mapping, networking matrix) into references/plan.md, leaving SKILL.md with the decision summaries and the reference pointer.

DimensionReasoningScore

Conciseness

The 384-line body is information-dense and largely earns its tokens, but several passages repeat guidance already stated elsewhere (e.g. the KCP first-mention intro recurs across Scope, Mode Detection, Intake Path Selection, and Invariants; the .md-vs-.html citation rule is re-explained in both Skill Conduct and Sources of Truth). This is 'mostly efficient but includes some unnecessary explanation or could be tightened,' matching the score-3 anchor. Not a 4 because the repetition is noticeable rather than minor, and not a 2 because the content is not padded with concepts Claude already knows — it is genuine migration-specific judgment.

3 / 5

Actionability

Provides concrete, executable guidance throughout — named KCP commands (`kcp scan clusters`, `kcp migration lag-check`, `kcp report costs`), a Tool Routing table mapping each operation to a preferred command with fallbacks, and a Source Map with exact docs.confluent.io URLs and what to extract. Matches the 'mostly executable guidance; concrete code or commands with minor gaps' anchor. Not a 5 because the body itself contains no copy-paste-ready code snippets (those live in references), and not a 3 because the commands and fetch targets are specific and runnable rather than pseudocode.

4 / 5

Workflow Clarity

The Stage Workflow table lays out entry criteria, exit artifacts, and reference files per stage with 'each stage validates its own work before handoff', and the Invariants section adds explicit validation checkpoints (e.g. 'verify kcp migration lag-check shows zero lag before executing', 'terraform plan before terraform apply', rollback documented before switchover). Matches the 'clear sequence with most checkpoints present; minor validation gaps' anchor. Not a 5 because the main body's validation steps are stated as invariants rather than woven into a per-stage feedback loop (validate → fix → retry), and the skill explicitly delegates the most fragile operations (CL setup, cutover execution) to out-of-scope docs, leaving some recovery-loop detail to the references.

4 / 5

Progressive Disclosure

SKILL.md is structured as an overview with a Reference File Index pointing one level deep to real files — references/assess.md, references/plan.md, references/kcp-commands.md, references/mcp-integration.md (all present on disk) — plus assets/migration-profile.yaml, and each stage's deep detail is offloaded to the corresponding reference. Matches the 'good structure; most content appropriately placed; references mostly clear' anchor. Not a 5 because some content that arguably belongs in references (the large Cross-Stage Decision Logic tables and the long Skills-Conduct citation rule) is inlined in SKILL.md, and not a 3 because references are clearly signaled and the split is generally sound.

4 / 5

Total

15

/

20

Passed

Description

90%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.

The description is strong: it states concrete capabilities, surfaces a comprehensive set of natural trigger phrases, explicitly answers both what and when, and uses negative-scope triggers to carve a distinct MSK-only niche. Specificity is the only slightly-lower dimension, owing to a few implied rather than enumerated sub-tasks.

DimensionReasoningScore

Specificity

Names the domain and lists several specific concrete actions — 'assess and plan a migration', 'cluster sizing', 'Cluster Linking setup', 'Gateway-based switchover', 'post-cutover validation' — but stops short of comprehensive enumeration of all sub-tasks, leaving minor coverage gaps. Not a 5 because it does not exhaustively enumerate every concrete action (e.g. schema/connector migration paths are only implied), and not a 3 because it clearly lists multiple specific actions rather than just one or two.

4 / 5

Completeness

Clearly answers both 'what' (assess and plan a migration from AWS MSK to Confluent Cloud, with the listed capabilities) and 'when' via an explicit 'Triggers on user intent like ...' clause plus negative-scope 'Do NOT trigger' guidance. Matches the anchor that explicitly answers both what and when with concrete trigger phrases; not a 4 because the 'when' is fully explicit rather than only loosely specified.

5 / 5

Trigger Term Quality

Comprehensive coverage of natural user phrasings with synonyms and tool-specific keywords — 'migrate MSK to Confluent Cloud', 'move off MSK', 'MSK to CC cutover', 'Zero-Cut migration from MSK', 'kcp scan my MSK' — matching the anchor that lists multiple natural terms including synonyms. Not below 5 because the term coverage is broad and directly mirrors how a practitioner would phrase the request.

5 / 5

Distinctiveness Conflict Risk

A clear MSK-only niche with explicit negative triggers ('Do NOT trigger for non-MSK Kafka sources', 'greenfield Confluent Cloud projects', 'general Kafka programming questions') minimizes conflict with adjacent skills. Matches the clear-niche anchor with distinct triggers and minimal conflict risk; not below 5 because the exclusions actively prevent mis-routing.

5 / 5

Total

19

/

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
confluentinc/agent-skills
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.