CtrlK
BlogDocsLog inGet started
Tessl Logo

amazon-bedrock

Builds generative AI applications on Amazon Bedrock. Covers model invocation (Converse API, InvokeModel), RAG with Knowledge Bases, Bedrock Agents, Guardrails, and AgentCore (including the Harness managed agent loop). Applies when invoking models, setting up Knowledge Bases, creating agents, applying guardrails, deploying to AgentCore, migrating/porting/converting a Bedrock Agent (including inline agents) to an AgentCore Harness, troubleshooting Bedrock errors (ThrottlingException, AccessDeniedException), or choosing models (Claude, Llama, Nova, Titan). Also for prompt caching, quota and throttling diagnosis, cost tracking, migrating between Claude model generations (4.5 to 4.6 to 4.7), chunking strategies, API selection (Converse vs InvokeModel), guardrail capabilities, and model selection. Also covers AgentCore Payments (x402, microtransactions, Payment Manager, Connector, Instrument, Coinbase CDP, Stripe Privy, paid endpoints, agent payments). NOT for custom model training, Rekognition, or Comprehend.

74

Quality

91%

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

82%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 strong, action-dense router skill: concrete CLI commands, exact error-to-cause mappings, explicit decision defaults (Managed KB first, Converse over InvokeModel, Harness for new agents), and every referenced bundle file verified to exist. The main deductions are deliberate repetition of the maxTokens and 'read the reference first' mandates, and second-level reference nesting inside the migration and payments bundles.

Suggestions

Consolidate the maxTokens/ThrottlingException warning into the Critical Warnings section and reference it once from the Converse, Troubleshooting, and Example sections instead of restating the full explanation four times.

Vary or compress the repeated 'You MUST read [X] before responding' mandate into a single up-front rule listing the reference-per-topic table, cutting several near-duplicate sentences.

Flatten the second-level references in the migration bundle (inline the small eligibility/cli notes into migrate-bedrock-agents-to-agentcore-harness.md or link them directly from SKILL.md's routing table) so all references remain one level deep.

DimensionReasoningScore

Conciseness

The body is an efficient router — tables, decision guides, and pointers rather than concept explanations Claude already knows. However, the maxTokens/ThrottlingException warning is repeated in Critical Warnings, the Converse section, Throttleshooting, and Examples 1 and 7, and 'You MUST read [X] before responding' is restated nearly verbatim across many sections. This is deliberate emphasis but is trimming-able, matching 'Efficient; minor instances of over-explanation that could be trimmed' rather than the lean anchor 5.

4 / 5

Actionability

Concrete, copy-paste-ready commands cover the common cases: `aws bedrock list-foundation-models --region us-east-1`, the full Example 4 converse command with model ID and `--inference-config '{"maxTokens":1024}'`, quota-check commands, retry config `Config(retries={"max_attempts": 5, "mode": "adaptive"})`, and exact error names mapped to specific fixes (e.g., the double-underscore action-group name pattern, `prepare-agent` after config changes).

5 / 5

Workflow Clarity

Workflows are sequenced with most checkpoints present: the Invoke-a-model checklist, KB create → connector → ingest → 'verify with Retrieve', 'polling get-harness until status READY', and 'Run prepare-agent after ANY configuration change'. It falls short of anchor 5 because several multi-step procedures (agents, guardrails, AgentCore deploy) delegate their detailed sequence and validation checkpoints to reference files rather than showing feedback loops inline — the body states the gates exist but the fix-and-retry loops themselves live one level down.

4 / 5

Progressive Disclosure

The body is a well-signaled overview with one-level-deep references (all 25 referenced `references/*.md` paths and `scripts/fetch_bedrock_agent.py` verified to exist), a TOC, and routing tables per capability. Scored against the actual bundle structure, it does not quite reach anchor 5 because two areas nest a second level: `migrate-bedrock-agents-to-agentcore-harness.md` links into `references/bedrock-agents-to-agentcore-harness/{cli,deploy,discovery,eligibility,mapping}.md`, and `agentcore-payments.md` links to `agentcore-payments-setup-script.md` and `agentcore-payments-wiring.md`. Good structure overall with minor organization gaps.

4 / 5

Total

17

/

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.

An excellent description: concrete capabilities, explicit 'Applies when...' triggers with synonyms, negative triggers for boundary disambiguation, and third-person voice throughout. The only minor nit is that 'model selection', 'guardrails', and 'Converse vs InvokeModel' each appear twice across the trigger lists, adding slight length without adding new trigger value.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with comprehensive coverage: 'model invocation (Converse API, InvokeModel), RAG with Knowledge Bases, Bedrock Agents, Guardrails, and AgentCore', plus migration, troubleshooting, prompt caching, and cost tracking. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and stays in third person ('Builds', 'Covers', 'Applies').

5 / 5

Completeness

Explicitly answers both: what ('Builds generative AI applications on Amazon Bedrock. Covers...') and when ('Applies when invoking models, setting up Knowledge Bases, creating agents...'), with concrete trigger phrases and even negative triggers ('NOT for custom model training, Rekognition, or Comprehend'). This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including explicit synonyms users would actually say: 'migrating/porting/converting', 'ThrottlingException, AccessDeniedException', 'prompt caching', 'quota and throttling diagnosis', 'cost tracking', 'choosing models (Claude, Llama, Nova, Titan)'. It includes error names and task phrasings a user would naturally utter.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Amazon Bedrock and its named sub-services) with distinct triggers and explicit exclusions ('NOT for custom model training, Rekognition, or Comprehend') that prevent it firing for adjacent AWS AI skills. Minimal conflict risk.

5 / 5

Total

20

/

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