CtrlK
BlogDocsLog inGet started
Tessl Logo

agents-get-started

Use when a developer wants to create a new agent project or get started with AgentCore. Handles framework selection, project scaffolding, first deploy, and first invocation. Triggers on: "build an agent", "create an agent", "get started", "new project", "agentcore create", "which framework", "Strands vs LangGraph", "hello world agent", "first agent", "create MCP server", "host MCP server", "agentcore dev", "dev server", "what port", "local development". Not for adding capabilities to existing projects — use agents-build or agents-connect. Strands vs LangGraph in a migration context routes to agents-build, not here. Connecting to an existing MCP server routes to agents-connect, not here.

75

Quality

94%

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.

The content is a strong, highly executable get-started workflow: every step has concrete commands, validation checkpoints, and error-recovery paths, and sequencing is unambiguous. Its main weaknesses are mild verbosity in a few coaching-style passages and a monolithic main file where framework-comparison and BYO-container detail could be moved to one-level-deep references. The example reference file is real, well-structured, and appropriately linked.

Suggestions

Trim the project-name validation prose to the three rules plus one example (the four char-counted examples are more coaching than needed) to lift conciseness toward 5.

Move the 'Framework not listed?' table, BYO Container path, and language-specific notes into a references file (e.g. references/byo-container.md), keeping only a one-line pointer in Step 2 to slim the ~340-line body.

Consider condensing the 'Framework vs. model provider — a common confusion' section to the two-sentence routing rule, since the underlying distinction is general knowledge.

DimensionReasoningScore

Conciseness

The body is largely efficient — tables carry the framework, flag, port, and next-step information, and no space is spent explaining what agents or AWS are. A few passages could be trimmed, e.g. the four worked name-length examples ('MyCustomerSupportAgent is 22 chars and fits...') and the 'Framework vs. model provider — a common confusion' explainer, which pushes it below anchor 5's 'every token earns its place' but above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Every step gives copy-paste-ready commands: 'agentcore create --name <ProjectName> --defaults', a full flag reference table with values and defaults, exact port numbers, concrete error-recovery guidance ('grep ps / check the CLI banner if invocations start failing'), and a ready-to-present example command block. This matches anchor 5's 'fully executable; copy-paste ready... specific examples cover the common cases'.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced with explicit validation checkpoints and feedback loops: re-checking 'agentcore --version' after update, validating the project name before constructing the command, presenting the command for confirmation before running, and port-conflict recovery for dev failures. This matches anchor 5 ('explicit validation steps; feedback loops for error recovery'), and no destructive/batch cap applies since deploy requires confirmation.

5 / 5

Progressive Disclosure

The single bundle reference (references/example-support-agent.md) is one level deep and clearly signaled via a task-mapped table, and cross-skill links (../agents-build/references/migrate.md) are explicit. However, the main file at ~340 lines inlines substantial peripheral content — the 'Framework not listed?' table, BYO Container workflow, language-specific notes — that could live in references to slim the overview, matching anchor 4's 'most content appropriately placed; minor organization gaps' rather than anchor 5's clean overview/split.

4 / 5

Total

18

/

20

Passed

Description

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

This is an exemplary description: it states concrete capabilities, gives an explicit 'Use when' clause with a comprehensive list of natural trigger phrases, and proactively routes edge cases (migration, existing MCP servers) away to sibling skills. The boundary disambiguation is especially valuable in a multi-skill suite and keeps conflict risk minimal. Its length is justified by routing information rather than padding.

DimensionReasoningScore

Specificity

The description lists four concrete, lifecycle-complete actions — 'Handles framework selection, project scaffolding, first deploy, and first invocation' — which comprehensively cover the skill's scope from zero to a running agent. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' rather than score 4, whose coverage has minor gaps.

5 / 5

Completeness

Both 'what' ('Handles framework selection, project scaffolding, first deploy, and first invocation') and 'when' (an explicit 'Use when a developer wants to...' clause plus a 'Triggers on:' list of concrete phrases) are clearly and explicitly answered. Score 4 would require the 'when' to be less explicit; here it is maximally explicit.

5 / 5

Trigger Term Quality

It enumerates fifteen natural phrases users would actually say ('build an agent', 'get started', 'hello world agent', 'first agent', 'dev server', 'what port', 'Strands vs LangGraph'), including CLI-specific terms and synonyms. This is comprehensive coverage including variations, matching anchor 5 rather than anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (new-project creation) and actively disambiguates against sibling skills: 'Not for adding capabilities to existing projects — use agents-build or agents-connect', migration-context and existing-MCP-server routing. Triggers are specific to greenfield intent, so conflict risk is minimal — matching anchor 5 rather than anchor 4's 'minor overlap risk'.

5 / 5

Total

20

/

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: 3 suspicious

Warning

referenced_paths_exist

Referenced path issues: 3 missing

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.