Skip to content
Back to search

arvancloud-agent-skill

Unofficial Agent Skill for Claude Code and other SKILL.md-compatible agents, driving ArvanCloud's APIs (CDN, DNS, IaaS, Object Storage, Edge, CaaS, VOD/Live/Video Ads) and Let's Encrypt DNS-01 certs via acme.sh.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/erfnzdeh--arvancloud-agent-skill/badge.svg)](/listings/erfnzdeh--arvancloud-agent-skill)

HTML

<a href="/listings/erfnzdeh--arvancloud-agent-skill"><img src="/api/listings/erfnzdeh--arvancloud-agent-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Primary (Claude Code, Cursor, Codex, and 60+ other agents):

npx skills add erfnzdeh/arvancloud-agent-skill

That command discovers the `arvancloud-api` skill in this repo. If the installer asks which skill to add, choose `arvancloud-api`.

npm / skillpm

npx skillpm install arvancloud-api-skill

Package: [`arvancloud-api-skill`](https://www.npmjs.com/package/arvancloud-api-skill) on npm.

Claude Code plugin

/plugin marketplace add erfnzdeh/arvancloud-agent-skill
/plugin install arvancloud-api@arvancloud-agent-skill

The marketplace name is `arvancloud-agent-skill`; the plugin name is `arvancloud-api`. Submitted to Anthropic's plugin directory for review.

Cursor

Browse or install from [cursor.directory/plugins/arvancloud-api](https://cursor.directory/plugins/arvancloud-api). The listing may stay hidden until their security scan finishes.

Cursor also picks the skill up from a clone (below) or from `npx skills add`.

Manual clone

Personal (Claude Code):

git clone https://github.com/erfnzdeh/arvancloud-agent-skill.git ~/.claude/skills/arvancloud-api

Personal (Cursor):

git clone https://github.com/erfnzdeh/arvancloud-agent-skill.git ~/.cursor/skills/arvancloud-api

Project-specific clones work the same way under `.claude/skills/` or `.cursor/skills/`. Cursor also loads compatible skills from `.claude/skills/`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "arvancloud-agent-skill",
  4. "owner": {
  5. "name": "erfnzdeh",
  6. "email": "erfnzdeh@gmail.com"
  7. },
  8. "metadata": {
  9. "description": "Unofficial ArvanCloud API skill for Claude Code, Cursor, and other SKILL.md agents.",
  10. "version": "1.2.0"
  11. },
  12. "plugins": [
  13. {
  14. "name": "arvancloud-api",
  15. "source": "./",
  16. "description": "Operate ArvanCloud APIs, DNS records, Cloud Server/IaaS, Object Storage, VOD/Live, CDN/Security, and Let's Encrypt DNS-01 certificates via acme.sh dns_arvan.",
  17. "version": "1.2.0"
  18. }
  19. ]
  20. }
README.md · README · 118 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ArvanCloud's API Agent Skill
  2. [![skills.sh](https://skills.sh/b/erfnzdeh/arvancloud-agent-skill)](https://skills.sh/erfnzdeh/arvancloud-agent-skill)
  3. [![npm](https://img.shields.io/npm/v/arvancloud-api-skill)](https://www.npmjs.com/package/arvancloud-api-skill)
  4. [![license](https://img.shields.io/github/license/erfnzdeh/arvancloud-agent-skill)](LICENSE)
  5. [![stars](https://img.shields.io/github/stars/erfnzdeh/arvancloud-agent-skill)](https://github.com/erfnzdeh/arvancloud-agent-skill/stargazers)
  6. ![type](https://img.shields.io/badge/type-Agent_Skill-blueviolet)
  7. ![works with](https://img.shields.io/badge/works_with-Claude_Code-D97757?logo=claude&logoColor=white)
  8. ![works with](https://img.shields.io/badge/works_with-Cursor-000000)
  9. ![status](https://img.shields.io/badge/status-unofficial-orange)
  10. Unofficial, community-maintained [Agent Skill](https://agentskills.io) for driving [ArvanCloud](https://arvancloud.ir)'s APIs (CDN, DNS, Cloud Server / IaaS, Object Storage, Edge Computing, Cloud Container, VOD/Live/Video Ads) and issuing Let's Encrypt wildcard TLS certs via acme.sh's `dns_arvan` plugin, from Claude Code, Cursor, or any agent that supports the `SKILL.md` format.
  11. Not affiliated with or endorsed by ArvanCloud.
  12. ## Install
  13. Primary (Claude Code, Cursor, Codex, and 60+ other agents):
  14. ```bash
  15. npx skills add erfnzdeh/arvancloud-agent-skill
  16. ```
  17. That command discovers the `arvancloud-api` skill in this repo. If the installer asks which skill to add, choose `arvancloud-api`.
  18. ### npm / skillpm
  19. ```bash
  20. npx skillpm install arvancloud-api-skill
  21. ```
  22. Package: [`arvancloud-api-skill`](https://www.npmjs.com/package/arvancloud-api-skill) on npm.
  23. ### Claude Code plugin
  24. ```text
  25. /plugin marketplace add erfnzdeh/arvancloud-agent-skill
  26. /plugin install arvancloud-api@arvancloud-agent-skill
  27. ```
  28. The marketplace name is `arvancloud-agent-skill`; the plugin name is `arvancloud-api`. Submitted to Anthropic's plugin directory for review.
  29. ### Cursor
  30. Browse or install from [cursor.directory/plugins/arvancloud-api](https://cursor.directory/plugins/arvancloud-api). The listing may stay hidden until their security scan finishes.
  31. Cursor also picks the skill up from a clone (below) or from `npx skills add`.
  32. ### Manual clone
  33. Personal (Claude Code):
  34. ```bash
  35. git clone https://github.com/erfnzdeh/arvancloud-agent-skill.git ~/.claude/skills/arvancloud-api
  36. ```
  37. Personal (Cursor):
  38. ```bash
  39. git clone https://github.com/erfnzdeh/arvancloud-agent-skill.git ~/.cursor/skills/arvancloud-api
  40. ```
  41. Project-specific clones work the same way under `.claude/skills/` or `.cursor/skills/`. Cursor also loads compatible skills from `.claude/skills/`.
  42. ## Setup
  43. No credentials live in this repo. In Claude Code, save your API key in the plugin's settings (`/plugin configure arvancloud-api@arvancloud-agent-skill`): it is kept in your system's credential store and handed to Claude's shell at the start of each session by a small hook (`hooks/export-plugin-key.sh`). Everywhere else, the skill reads the key from an environment variable at runtime (default name `$ARVAN_KEY`: confirm the real name; see Setup in [`skills/arvancloud-api/SKILL.md`](skills/arvancloud-api/SKILL.md)). Per-user state (region, cert-deploy hooks) belongs in `~/.config/arvan/config.json`.
  44. ## What it covers
  45. - CloudDNS records and domains, cache purge, CDN security settings
  46. - Cloud Server / IaaS: v3 regional API, legacy v1, and the undocumented v2 backup and volume routes
  47. - Regions and availability zones, including which v3 hosts actually work
  48. - Object Storage management API and S3 endpoints (separate auth scheme)
  49. - Edge Computing, Cloud Container, VOD, Live, Video Ads
  50. - Account identity (`/v1/me`), multi-account keys, and a table of real error responses
  51. - Let's Encrypt DNS-01 wildcards via acme.sh `dns_arvan`
  52. - Two API helper scripts: a safe request wrapper and a read-only account inventory
  53. Hosts, paths and response shapes were checked against the published OpenAPI specs and read-only live calls.
  54. ## What's in here
  55. - `skills/arvancloud-api/SKILL.md`: the skill itself (frontmatter + instructions, product map, auth, gotchas).
  56. - `skills/arvancloud-api/references/dns-and-tls.md`: DNS records, domains, cache purge, CDN settings, Let's Encrypt wildcard cert issuance.
  57. - `skills/arvancloud-api/references/iaas.md`: Cloud Server v3, v1 and v2, regions, create body, backups, quota.
  58. - `skills/arvancloud-api/references/object-storage.md`: Object Storage management API, S3 endpoints, usage reports.
  59. - `skills/arvancloud-api/references/products.md`: Edge Computing, Live, VOD, Video Ads, Cloud Container.
  60. - `skills/arvancloud-api/references/mcp-cross-check.md`: corrections against `arvancloud-mcp`, the official CLI, and earlier versions of this skill.
  61. - `skills/arvancloud-api/scripts/arvan-api.sh`: request wrapper (key resolution, write guard, retries, error hints).
  62. - `skills/arvancloud-api/scripts/arvan-inventory.sh`: read-only snapshot of one account.
  63. - `skills/arvancloud-api/assets/config.example.json`: placeholder for per-user config (no secrets, just env var *names*).
  64. - `.claude-plugin/`: Claude Code marketplace + plugin manifests.
  65. - `.cursor-plugin/`: Cursor plugin manifest.
  66. - `package.json`: npm / skillpm package `arvancloud-api-skill`.
  67. ## Listings
  68. | Hub | Link |
  69. | --- | --- |
  70. | GitHub | [erfnzdeh/arvancloud-agent-skill](https://github.com/erfnzdeh/arvancloud-agent-skill) |
  71. | skills.sh | [skills.sh/erfnzdeh/arvancloud-agent-skill](https://skills.sh/erfnzdeh/arvancloud-agent-skill) |
  72. | npm | [arvancloud-api-skill](https://www.npmjs.com/package/arvancloud-api-skill) |
  73. | Cursor Directory | [cursor.directory/plugins/arvancloud-api](https://cursor.directory/plugins/arvancloud-api) |
  74. | Cursor Forum | [Built for Cursor](https://forum.cursor.com/t/arvancloud-api-unofficial-agent-skill-for-arvancloud-dns-iaas-object-storage-cdn-and-lets-encrypt/171446) |
  75. | Claude plugin directory | Submitted via Console; self-serve install is the `/plugin marketplace add` path above |
  76. The skills.sh website index can lag the CLI. If search does not show the skill yet, install with `npx skills add` anyway.
  77. ## Contributing
  78. See [CONTRIBUTING.md](CONTRIBUTING.md). Endpoint corrections and gotchas
  79. go in [issues](https://github.com/erfnzdeh/arvancloud-agent-skill/issues).
  80. Security reports are private: see [SECURITY.md](SECURITY.md).
  81. ## License
  82. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.