CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-advisor

Entry point for AI-agent work on AWS: pick a runtime, plan a migration for existing workloads, and build an executable POC — one phased flow. Triggers on: which runtime for my agent, AgentCore vs ECS vs EKS vs Lambda, AgentCore vs Lambda MicroVMs, deploy an AI agent on AWS, agent architecture on AWS, I have an agent idea what do I build, move/migrate my agents to AWS, agent migration plan, add AgentCore services (memory, gateway, identity, policy, observability) to an agent already on AWS, Temporal on AWS (migrate/run Temporal workers on AWS, a service orchestrated by Temporal, Temporal Cloud vs self-hosted). Temporal Workflow code is never rewritten into Step Functions. Requires at least one agentic component — a purely non-agent system (plain services, batch jobs, HTTP endpoints, non-agent Temporal Activities) is out of scope, redirected to gcp-to-aws / heroku-to-aws / llm-to-bedrock. Not for: compute/data migration with no AI agent; pure LLM SDK rewrite (use llm-to-bedrock); per-model pricing.

66

Quality

81%

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

67%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 sophisticated, well-architected orchestration skill: explicit routing, gates, state schema, and validation checkpoints, with an excellent one-level-deep bundle layout. The costs are density and length — the gate-semantics and contextual-offers sections read as compressed rulebooks that could partly live in reference files, and cross-skill dependencies assume siblings that are not vendored here.

Suggestions

Tighten conciseness by moving the ~55-line Contextual offers closing step into its own reference file (e.g. references/decision-refs/contextual-offers.md), leaving SKILL.md with a short trigger rule and pointer.

Rewrite the Gate 2 paragraph as a small bulleted decision table (entry point × migration_plan state → Gate 2 offered or not) so its nested conditionals are scannable instead of a single tangled sentence.

Condense the $PLUGIN fallback definition to the two-line rule (try ${CLAUDE_PLUGIN_ROOT}, else skill-relative) and cut the explanatory prose about where files live, which the Files table already conveys.

DimensionReasoningScore

Conciseness

The body is dense operational state-machine prose rather than padded tutorials — no explaining of concepts Claude already knows — but several sections could be tightened: the "$PLUGIN" fallback paragraph, the Gate 2 paragraph's nested conditionals ("only when … or … on build_deploy only … OR when …"), and the ~55-line "Contextual offers" section with its long nested parentheticals. This matches anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than anchor 4, since more than minor trimming is possible.

3 / 5

Actionability

Guidance is highly concrete and executable for an orchestration skill: exact file paths ("begin at references/phases/intake/intake.md"), a checkable prerequisite command ("uv --version"), a full .phase-status.json example with status values, precise gate conditions keyed to named state fields, and a read-merge-write update discipline. It sits just under anchor 5 because several instructions resolve only by chaining into phase files (e.g. "generate.md Step 5.5", "migration-plan.md Step -1") and into sibling-skill files outside this bundle, so the SKILL.md alone is not fully self-executing.

4 / 5

Workflow Clarity

The backbone sequence is explicit (intake → … → complete), entry-point routing enumerates each path, and validation is prominent: the phase gate ("Do NOT load design.md … unless … phases.clarify == 'completed' AND phases.confirm == 'completed'"), the recommendation_reviewed precondition for all gates, schema/run_id validation of verification evidence, and resumability via persisting poc=in_progress before loading. It misses anchor 5 because the Gate 2 offer conditions in particular are a tangled multi-clause paragraph that a reader must unpack, and some checkpoint details live implicitly in the referenced phase files.

4 / 5

Progressive Disclosure

Bundle structure is exemplary: a Files table mapping every reference to its purpose, phases split one per directory, per-topic decision-refs, per-runtime JSON profiles, and a vendored INTERPRETER.md as the single execution contract — and spot checks confirm all listed paths (phases/, decision-refs/, runtimes/, vendored/dsl/INTERPRETER.md, scripts/scoring.py, scripts/schemas/seed.json) exist. It falls short of anchor 5 because the 206-line body is itself a dense controller (the Contextual-offers closing step in particular is inline procedural content that belongs in its own reference file), and it depends on sibling-bundle files (../knowledge-base-for-startups/references/offers.md, ../contextual-offers-for-startups/SKILL.md, ../architect-for-startups/…) that are not part of this skill's bundle.

4 / 5

Total

15

/

20

Passed

Description

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

An exceptionally well-constructed description: explicit what/when, exhaustive natural trigger phrasings, and explicit out-of-scope redirects that prevent mis-triggering against sibling skills. The only soft spot is that the capability summary omits a few of the skill's actual deliverables, which keeps specificity at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "pick a runtime", "plan a migration for existing workloads", "build an executable POC — one phased flow", and add AgentCore capabilities — which names the domain and multiple specific operations. It stops short of anchor 5 because the capability list omits deliverables like the layered recommendation doc, cost estimate, and diagram that the skill actually produces, leaving minor gaps in coverage.

4 / 5

Completeness

It explicitly answers both questions: the "what" up front ("Entry point for AI-agent work on AWS: pick a runtime, plan a migration for existing workloads, and build an executable POC") and the "when" via a literal "Triggers on:" clause plus a "Not for:" exclusion list with redirects to sibling skills. This matches anchor 5's requirement of concrete trigger phrases for both what and when; anchor 4 would require the "when" to be less explicit than it is.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural: "which runtime for my agent", "AgentCore vs ECS vs EKS vs Lambda", "AgentCore vs Lambda MicroVMs", "deploy an AI agent on AWS", "I have an agent idea what do I build", "move/migrate my agents to AWS", "Temporal Cloud vs self-hosted" — covering synonyms, product-name variations, and phrasings users would actually type. It clearly exceeds anchor 4 ("a few natural terms missing") since both casual and expert phrasings are present.

5 / 5

Distinctiveness Conflict Risk

The niche is sharply defined (AI-agent runtime decisions on AWS) and it proactively de-conflicts by redirecting near-misses to named siblings ("redirected to gcp-to-aws / heroku-to-aws / llm-to-bedrock", "pure LLM SDK rewrite (use llm-to-bedrock)"). Named AWS products (AgentCore, Lambda MicroVMs, Temporal) give it distinct trigger tokens, matching anchor 5's clear-niche/minimal-conflict standard.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 2 suspicious

Warning

referenced_paths_exist

Referenced path issues: 20 deeper-than-1-level

Warning

Total

14

/

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.