chore(doc): update docs to include context on plugins, links

README.md

@@ -3,7 +3,26 @@
 > [!IMPORTANT]
 > Generative AI can make mistakes. You should consider reviewing all output and costs generated by your chosen AI model and agentic coding assistant. See [AWS Responsible AI Policy](https://aws.amazon.com/ai/responsible-ai/policy/).
 
-Agent Plugins for AWS equip AI coding agents with the skills to help you architect, deploy, and operate on AWS. Agent plugins are currently supported by Claude Code.
+Agent Plugins for AWS equip AI coding agents with the skills to help you architect, deploy, and operate on AWS. Agent plugins are currently supported by Claude Code and Cursor.
+
+AI coding agents are increasingly used in software development, helping developers write, review, and deploy code more efficiently. Agent skills and the broader agent plugin packaging model are emerging as best practices for steering coding agents toward reliable outcomes without bloating model context. Instead of repeatedly pasting long AWS guidance into prompts, developers can now encode that guidance as reusable, versioned capabilities that agents invoke when relevant. This improves determinism, reduces context overhead, and makes agent behavior easier to standardize across teams. Agent plugins act as containers that package different types of expertise artifacts together. A single agent plugin can include:
+
+- Agent skills – Structured workflows and best-practice playbooks that guide AI through complex tasks like deployment, code review, or architecture planning. Agent skills encode domain expertise as step-by-step processes.
+- MCP servers – Connections to external services, data sources, and APIs. MCP servers give your assistant access to live documentation, pricing data, and other resources at runtime. Learn more about [MCP servers for AWS](https://github.com/awslabs/mcp).
+- Hooks – Automation and guardrails that run on developer actions. Hooks can validate changes, enforce standards, or trigger workflows automatically.
+- References – Documentation, configuration defaults, and knowledge that the agent skill can consult. References make agent skills smarter without bloating the prompt.
+
+As new types of expertise artifacts emerge in this space, they can be packaged into agent plugins, making the evolution transparent to developers.
+
+## Best practices
+
+To maximize the benefits of plugin-assisted development while maintaining security and code quality, follow these essential guidelines:
+
+- Always review generated code before deployment (for example, against your constraints for security, cost, resilience)
+- Use plugins as accelerators, not replacements for developer judgment and expertise.
+- Keep plugins updated to benefit from the latest AWS best practices.
+- Follow the principle of least privilege when configuring AWS credentials.
+- Run security scanning tools on generated infrastructure code.
 
 ## Plugins
 
@@ -29,12 +48,14 @@ Agent Plugins for AWS equip AI coding agents with the skills to help you archite
 
 ### Cursor
 
-Use the official [Cursor marketplace](https://cursor.com/marketplace) to install the plugins from this repository. For additional information, please refer to the [documentation](https://cursor.com/docs/plugins).
+You can install the **deploy-on-aws** plugin from the [Cursor Marketplace](https://cursor.com/marketplace/aws). For additional information, please refer to the [Cursor plugin documentation](https://cursor.com/docs/plugins). You can also install within the Cursor application:
 
 - Open Cursor Settings
-- Navigate to `Plugins`, and in the search bar type `aws`
-- Select the plugin you want to install, and Click `add to cursor`, then select the scope
-- Now the plugin should appear under `Plugins -> installed`
+- Navigate to `Plugins`
+- Search for `AWS`
+- Select the plugin you want to install and click `Add to Cursor`
+- Select the scope for the installed plugin
+- The plugin should appear under `Plugins -> Installed`
 
 ## deploy-on-aws
 
@@ -48,11 +69,11 @@ Equips agents with the skills to accelerate AWS deployment - recommending AWS ar
 4. **Generate** - Write IaC code (CDK/CloudFormation)
 5. **Deploy** - Execute with user confirmation
 
-### Skill Triggers
+### Agent Skill Triggers
 
-| Skill      | Triggers                                                                                                              |
-| ---------- | --------------------------------------------------------------------------------------------------------------------- |
-| **deploy** | "deploy to AWS", "host on AWS", "run this on AWS", "AWS architecture", "estimate AWS cost", "generate infrastructure" |
+| Agent Skill | Triggers                                                                                                              |
+| ----------- | --------------------------------------------------------------------------------------------------------------------- |
+| **deploy**  | "deploy to AWS", "host on AWS", "run this on AWS", "AWS architecture", "estimate AWS cost", "generate infrastructure" |
 
 ### MCP Servers
 
@@ -64,7 +85,7 @@ Equips agents with the skills to accelerate AWS deployment - recommending AWS ar
 
 ## Requirements
 
-- Claude Code >=2.1.29 or Cursor released >= Feb 17 2026
+- Claude Code >=2.1.29 or [Cursor >= 2.5](https://cursor.com/changelog/2-5)
 - AWS CLI configured with appropriate credentials
 
 ## Troubleshooting
@@ -89,6 +110,9 @@ Repository reviewers, maintainers, and admins can find PR review workflows, merg
 
 - [Introducing Agent Plugins for AWS Blog](https://aws.amazon.com/blogs/developer/introducing-agent-plugins-for-aws/)
 - [Extend Cursor with plugins ft. AWS](https://cursor.com/blog/marketplace)
+- [MCP Servers for AWS](https://github.com/awslabs/mcp)
+- [Claude Code plugins documentation](https://code.claude.com/docs/en/plugins)
+- [Cursor plugins documentation](https://cursor.com/docs/plugins)
 
 ## License