AWS agent-toolkit documentation change
Summary
Restructured content by replacing bullet points with section headings and expanded descriptions for skill access methods and skill types
Security assessment
The changes are purely organizational and presentational - converting bullet points to section headers with expanded text. No security vulnerabilities, configurations, or features are mentioned. The content about MCP Server runtime skill discovery doesn't discuss security implications of dynamic skill loading.
Diff
diff --git a/agent-toolkit/latest/userguide/skills.md b/agent-toolkit/latest/userguide/skills.md index 031299d51..246d0406c 100644 --- a//agent-toolkit/latest/userguide/skills.md +++ b//agent-toolkit/latest/userguide/skills.md @@ -38 +38 @@ There are three ways agents get access to skills: - * **Bundled with a plugin** — Each plugin includes a curated set of skills that are available to the agent immediately after installation. The agent can use these skills without any network calls or additional setup. +Bundled with a plugin @@ -40 +39,0 @@ There are three ways agents get access to skills: - * **Installed locally** — You can download individual skills from the [Agent Toolkit for AWS repository on GitHub](https://github.com/aws/agent-toolkit-for-aws) and add them to your agent's skills directory. @@ -42 +41 @@ There are three ways agents get access to skills: - * **Discovered at runtime via the AWS MCP Server** — Agents can search for and retrieve skills on demand through the AWS MCP Server, without any local installation. The agent uses the `search_documentation` tool to find relevant skills and the `retrieve_skill` tool to load them into context. +Each plugin includes a curated set of skills that are available to the agent immediately after installation. The agent can use these skills without any network calls or additional setup. @@ -43,0 +43 @@ There are three ways agents get access to skills: +Installed locally @@ -45,0 +46,6 @@ There are three ways agents get access to skills: +You can download individual skills from the [Agent Toolkit for AWS repository on GitHub](https://github.com/aws/agent-toolkit-for-aws) and add them to your agent's skills directory. + +Discovered at runtime via the AWS MCP Server + + +Agents can search for and retrieve skills on demand through the AWS MCP Server, without any local installation. The agent uses the `search_documentation` tool to find relevant skills and the `retrieve_skill` tool to load them into context. @@ -66 +72,9 @@ The Agent Toolkit for AWS includes several types of skills: - * **Service decision guides** help agents choose the right AWS service for a use case. For example, a database decision guide helps agents recommend DynamoDB, Aurora, or DSQL based on the workload requirements. +Service decision guides + + +These skills help agents choose the right AWS service for a use case. For example, a database decision guide helps agents recommend DynamoDB, Aurora, or DSQL based on the workload requirements. + +Step-by-step procedures + + +These skills provide tested workflows for common tasks like creating S3 Tables, setting up AWS Glue ETL pipelines, configuring IAM policies, and deploying serverless applications. @@ -68 +82 @@ The Agent Toolkit for AWS includes several types of skills: - * **Step-by-step procedures** provide tested workflows for common tasks like creating S3 Tables, setting up AWS Glue ETL pipelines, configuring IAM policies, and deploying serverless applications. +Troubleshooting guides @@ -70 +83,0 @@ The Agent Toolkit for AWS includes several types of skills: - * **Troubleshooting guides** provide diagnostic procedures for common errors, with steps to identify the cause and resolve the issue. For example, a CloudFormation deployment troubleshooting skill covers the top failure patterns and how to fix them. @@ -72 +85 @@ The Agent Toolkit for AWS includes several types of skills: - * **SDK usage guides** provide language-specific best practices for the AWS SDKs, covering common mistakes that models consistently get wrong (like DynamoDB marshalling in JavaScript or pagination patterns in Python). +These skills provide diagnostic procedures for common errors, with steps to identify the cause and resolve the issue. For example, a CloudFormation deployment troubleshooting skill covers the top failure patterns and how to fix them. @@ -73,0 +87 @@ The Agent Toolkit for AWS includes several types of skills: +SDK usage guides @@ -75,0 +90 @@ The Agent Toolkit for AWS includes several types of skills: +These skills provide language-specific best practices for the AWS SDKs, covering common mistakes that models consistently get wrong (like DynamoDB marshalling in JavaScript or pagination patterns in Python).