Content
# Agent Plugins for Alibaba Cloud (Unofficial)
> [!CAUTION]
> **This is an UNOFFICIAL, community-driven project.** It is NOT affiliated with, endorsed by, or sponsored by Alibaba Cloud (阿里云) or Alibaba Group.
>
> **Production use warning:** If you intend to use these plugins in a production environment, please exercise extreme caution. Review all generated code, configurations, and cost implications thoroughly before applying them to any production workload. The maintainers assume no liability for any damages or losses arising from the use of this project.
> [!IMPORTANT]
> Generative AI can make mistakes. You should consider reviewing all output and costs generated by your chosen AI model and agentic coding assistant.
Agent Plugins for Alibaba Cloud (Unofficial) equip AI coding agents with the skills to help you architect, deploy, and operate on Alibaba Cloud. Agent plugins are currently supported by Claude Code, Codex, 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 Alibaba Cloud 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.
- **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 Alibaba Cloud best practices.
- Follow the principle of least privilege when configuring Alibaba Cloud credentials (RAM).
- Run security scanning tools on generated infrastructure code.
## Plugins
| Plugin | Description | Status |
| ------ | ----------- | ------ |
| **alibabacloud-cli-usage** | Generate Alibaba Cloud CLI commands safely via MCP-based API discovery. No direct execution — commands are generated for review only. | Available |
| **alibabacloud-terraform** | Generate and modify Alibaba Cloud Terraform (HCL) code via MCP-based resource discovery and documentation. | Available |
## Installation
### Claude Code
#### Add the marketplace
```bash
/plugin marketplace add acloudlabs-unofficial/agent-plugins
```
#### Install a plugin
```bash
/plugin install alibabacloud-cli-usage@agent-plugins-for-alicloud
```
or
```bash
/plugin install alibabacloud-terraform@agent-plugins-for-alicloud
```
### Codex
Codex supports repo-local marketplaces and plugin manifests through
`.agents/plugins/marketplace.json` and per-plugin manifests under
`plugins/*/.codex-plugin/plugin.json`.
To try these plugins in Codex from this repo:
1. Clone this repository locally.
2. Open the repo in Codex so Codex can discover
`.agents/plugins/marketplace.json`.
3. Restart Codex.
4. Open the plugin directory, choose the `Agent Plugins for Alibaba Cloud (Unofficial)` marketplace,
and install the plugin you want to use.
## Security
If you discover a potential security issue in this project, please report it by opening a GitHub issue. Please do **not** include sensitive details in the issue body — provide only enough information for us to follow up.
## License
This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.
## Disclaimer
This project is independently maintained and is **not** an official Alibaba Cloud product. All Alibaba Cloud service names, trademarks, and logos are the property of Alibaba Group. Use of these names is for identification purposes only and does not imply endorsement.
