CtrlK
BlogDocsLog inGet started
Tessl Logo

aws-transform

Performs code upgrades, migrations, and transformations using the AWS Transform (ATX) CLI. Use when upgrading language versions, migrating AWS SDKs, migrating frameworks (Angular, Vue.js, Spring Boot, React), upgrading libraries, optimizing performance, migrating x86 to Graviton, analyzing codebases / generating documentation, or defining custom transformations with natural language. Runs locally on a few repositories or at scale across hundreds via AWS Batch/Fargate.

68

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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, well-sequenced operational skill with excellent validation checkpoints and a clean one-level-deep reference bundle. Its weaknesses are length — repeated guardrail phrasing, marketing copy, and a hardcoded changelog TD list inflate the token budget — and significant detail (Dockerfile customization, credential setup) inlined in SKILL.md that belongs in reference files.

Suggestions

Move the Dockerfile/entrypoint customization walkthrough (Step 6, custom image path) and the private-repo credential setup into references (e.g., remote-execution.md or a new credentials.md), leaving only the decision logic in SKILL.md.

Trim redundant 'Do NOT...' restatements to single directives and remove the duplicated 'If the user declines, suggest local mode' paragraph in Step 6.

Cut or compress the marketing greeting and the changelog's hardcoded TD list (which also conflicts with the 'never hardcode TD names' rule) to reduce token load.

DimensionReasoningScore

Conciseness

Most content is non-obvious operational detail (ATX CLI flags, IAM attachment scripts, S3 sync patterns), but there is real padding: the ~20-line marketing greeting, triple-stacked 'Do NOT skip this step. Do NOT ask... Do NOT condition it...' repetition, a duplicated 'If the user declines, suggest local mode' paragraph in Step 6, and a changelog that hardcodes 13 TD names. This sits between the 2 anchor (noticeably verbose) and 3 (mostly efficient with some unnecessary explanation), closer to 3 since the core guidance earns its tokens.

3 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: complete IAM policy-attachment bash script, `atx custom def list --json`, `aws s3 sync s3://user-bucket/repos/ ... --exclude "*" --include "*.zip"`, concrete Dockerfile RUN examples per language, and a signal-to-file detection table. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The 8-step workflow is clearly sequenced with explicit validation checkpoints and feedback loops: 'Do NOT proceed until `aws sts get-caller-identity` succeeds' with a re-run after setup, waiting for user confirmation at Steps 4 and 7, and re-running `atx custom def list --json` after TD creation. Batch operations are gated on explicit consent with per-mode concurrency limits, matching the 5 anchor (explicit validation, error-recovery loops).

5 / 5

Progressive Disclosure

The seven reference files exist, are one level deep, and are well signaled (in-body pointers plus a 'When to Use' table). However, substantial content that belongs in references is inlined in SKILL.md: ~100 lines of Dockerfile/entrypoint customization that duplicates remote-execution.md's scope, ~80 lines of private-repo credential setup, and the full changelog TD list. This fits the 3 anchor ('content that should be separate is inline') better than 4, where such gaps would be minor.

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 description: third-person voice, explicit 'Use when' triggers, and a comprehensive, concrete capability list anchored by AWS-specific terminology. The only weaknesses are a few missing natural synonyms (modernize, refactor) and language names, plus some broad triggers that could overlap with general code-migration skills.

Suggestions

Add the supported language names (Java, Python, Node.js) and common synonyms like 'modernize' or 'refactor' to the trigger list so users phrasing a request in those words still match.

Tighten broad triggers such as 'upgrading libraries' and 'optimizing performance' with AWS context (e.g., 'upgrading libraries in AWS-hosted repos') to reduce overlap with general refactoring skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with named targets — 'migrating AWS SDKs', 'migrating frameworks (Angular, Vue.js, Spring Boot, React)', 'migrating x86 to Graviton', 'analyzing codebases / generating documentation', 'defining custom transformations with natural language' — giving comprehensive coverage of the skill's capabilities. It clearly exceeds the 4 anchor, which allows for minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both questions: 'what' via 'Performs code upgrades, migrations, and transformations using the AWS Transform (ATX) CLI' and 'when' via an explicit 'Use when upgrading language versions, migrating AWS SDKs, ... or defining custom transformations' clause with concrete triggers. This matches the 5 anchor exactly; the 'when' clause is fully explicit, so 4 (when 'could be more explicit') does not apply.

5 / 5

Trigger Term Quality

Good natural-phrase coverage ('upgrading language versions', 'migrating frameworks', 'optimizing performance', 'x86 to Graviton', plus named frameworks), but common synonyms a user would naturally say — 'modernize', 'refactor', 'port' — and supported language names (Java, Python, Node.js) are absent. This fits the 4 anchor ('good keyword coverage; a few natural terms missing') rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The AWS-specific framing ('AWS Transform (ATX) CLI', 'migrating AWS SDKs', 'via AWS Batch/Fargate', Graviton) carves out a clear niche, but broad triggers like 'upgrading libraries' and 'optimizing performance' create minor overlap with general migration/refactoring skills. This is the 4 anchor ('mostly distinct; minor overlap risk with closely related skills') rather than 5, whose trigger set is unambiguously distinctive.

4 / 5

Total

18

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (843 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
aws/agent-toolkit-for-aws
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.