feat(skills): Add agent skills (#1755)

Co-authored-by: Nicholas Clegg <ncclegg@amazon.com>
Co-authored-by: Containerized Agent <agent@containerized-strands.local>
Co-authored-by: Strands Agent <217235299+strands-agent@users.noreply.github.com>
Co-authored-by: Nick Clegg <nac542@gmail.com>

Author: 4 people

AGENTS.md

@@ -130,7 +130,11 @@ strands-agents/
 │   ├── plugins/                          # Plugin system
 │   │   ├── plugin.py                     # Plugin base class
 │   │   ├── decorator.py                  # @hook decorator
-│   │   └── registry.py                   # PluginRegistry for tracking plugins
+│   │   ├── registry.py                   # PluginRegistry for tracking plugins
+│   │   └── skills/                       # Agent Skills integration
+│   │       ├── __init__.py               # Skills package exports
+│   │       ├── skill.py                  # Skill dataclass
+│   │       └── agent_skills.py            # AgentSkills plugin implementation
 │   │
 │   ├── handlers/                         # Event handlers
 │   │   └── callback_handler.py           # Callback handling

pyproject.toml

@@ -35,6 +35,7 @@ dependencies = [
     "mcp>=1.23.0,<2.0.0",
     "pydantic>=2.4.0,<3.0.0",
     "typing-extensions>=4.13.2,<5.0.0",
+    "pyyaml>=6.0.0,<7.0.0",
     "watchdog>=6.0.0,<7.0.0",
     "opentelemetry-api>=1.30.0,<2.0.0",
     "opentelemetry-sdk>=1.30.0,<2.0.0",

src/strands/__init__.py

@@ -4,17 +4,19 @@
 from .agent.agent import Agent
 from .agent.base import AgentBase
 from .event_loop._retry import ModelRetryStrategy
-from .plugins import Plugin
+from .plugins import AgentSkills, Plugin, Skill
 from .tools.decorator import tool
 from .types.tools import ToolContext
 
 __all__ = [
     "Agent",
     "AgentBase",
+    "AgentSkills",
     "agent",
     "models",
     "ModelRetryStrategy",
     "Plugin",
+    "Skill",
     "tool",
     "ToolContext",
     "types",

src/strands/plugins/__init__.py

@@ -6,8 +6,11 @@
 
 from .decorator import hook
 from .plugin import Plugin
+from .skills import AgentSkills, Skill
 
 __all__ = [
+    "AgentSkills",
     "Plugin",
+    "Skill",
     "hook",
 ]

src/strands/plugins/skills/__init__.py

@@ -0,0 +1,31 @@
+"""AgentSkills.io integration for Strands Agents.
+
+This module provides the AgentSkills plugin for integrating AgentSkills.io skills
+into Strands agents. Skills enable progressive disclosure of instructions:
+metadata is injected into the system prompt upfront, and full instructions
+are loaded on demand via a tool.
+
+Example Usage:
+    ```python
+    from strands import Agent
+    from strands.plugins.skills import Skill, AgentSkills
+
+    # Load from filesystem via classmethods
+    skill = Skill.from_file("./skills/pdf-processing")
+    skills = Skill.from_directory("./skills/")
+
+    # Or let the plugin resolve paths automatically
+    plugin = AgentSkills(skills=["./skills/pdf-processing"])
+    agent = Agent(plugins=[plugin])
+    ```
+"""
+
+from .agent_skills import AgentSkills, SkillSource, SkillSources
+from .skill import Skill
+
+__all__ = [
+    "AgentSkills",
+    "Skill",
+    "SkillSource",
+    "SkillSources",
+]