Docs
Agent Skills implementation for Strands Agents SDKFrom the repository description
npx -y skills add aws-samples/sample-strands-agents-agentskills --skill docsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
1.7 KB, 386 tokens by cl100k_base, as published. Nobody here has run it
English | 한국어
SKILL
A skill is essentially a folder containing a SKILL.md file. This file contains metadata (at minimum, a name and description) and instructions that tell an agent how to perform a specific task. Skills may also include scripts, templates, and reference materials.
my-skill/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
How SKILL Works
Skills use Progressive Disclosure to efficiently manage context.
- Discovery: The agent loads only the name and description of each available skill at startup. This is the minimum information needed to determine when a skill might be relevant.
- Activation: When a task matches a skill's description, the agent reads the full instructions from the SKILL.md file into context.
- Execution: The agent follows the instructions, loading referenced files or executing bundled code as needed.
SKILL.md Format
All skills start with a SKILL.md file containing YAML frontmatter and Markdown instructions.
---
name: web-research
description: Perform comprehensive research through web search and analysis
allowed-tools: WebFetch, Grep
license: MIT
---
# instructions
When using this Skill...
## Step 1: Search
...
Required Fields
name: kebab-case format (e.g.,web-research)description: What the Skill does and when to use it
Optional Fields
license: Skill licensecompatibility: Compatibility informationallowed-tools: Tool patterns the Skill can usemetadata: Custom key-value pairs