aliyun-openapi-discovery
Use when discovering and reconciling Alibaba Cloud product catalogs from Ticket System, Support & Service, and BSS OpenAPI; fetch OpenAPI product/version/API metadata; and summarize API coverage to plan new skills. Use when you need a complete product list, product-to-API mapping, or coverage/gap reports for skill generation.
How do I install this agent skill?
npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-openapi-discoveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a collection of discovery scripts for Alibaba Cloud's OpenAPI product catalog. It performs legitimate operations such as fetching product metadata from official Alibaba Cloud endpoints and merging them into reports. It follows standard security practices for managing cloud credentials via environment variables and uses the official Alibaba Cloud SDK.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Alibaba Cloud Product + API Discovery
Follow this workflow to collect products, resolve API metadata, and build summaries for skill planning.
Workflow
- Fetch product lists from the three sources
- Ticket System (ListProducts)
- Support & Service (ListProductByGroup)
- BSS OpenAPI (QueryProductList)
Run the bundled scripts (from this skill folder):
python scripts/products_from_ticket_system.py
python scripts/products_from_support_service.py
python scripts/products_from_bssopenapi.py
Provide required env vars in each script (see references).
- Merge product lists
python scripts/merge_product_sources.py
This writes output/product-scan/merged_products.json and .md.
- Fetch OpenAPI metadata product list
python scripts/products_from_openapi_meta.py
This writes output/product-scan/openapi-meta/products.json and products_normalized.json.
- Fetch OpenAPI API docs per product/version
python scripts/apis_from_openapi_meta.py
By default this can be large. Use filters for dry runs:
OPENAPI_META_MAX_PRODUCTS=10OPENAPI_META_PRODUCTS=Ecs,OnsOPENAPI_META_VERSIONS=2014-05-26
- Join products with API counts
python scripts/join_products_with_api_meta.py
- Summarize products by category/group
python scripts/summarize_openapi_meta_products.py
- (Optional) Compare products vs existing skills
python scripts/analyze_products_vs_skills.py
Output discipline
All generated files must go under output/. Do not place temporary files elsewhere.
Validation
mkdir -p output/aliyun-openapi-discovery
for f in skills/platform/openapi/aliyun-openapi-discovery/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-openapi-discovery/validate.txt
Pass criteria: command exits 0 and output/aliyun-openapi-discovery/validate.txt is generated.
Output And Evidence
- Save artifacts, command outputs, and API response summaries under
output/aliyun-openapi-discovery/. - Include key parameters (region/resource id/time range) in evidence files for reproducibility.
Prerequisites
- Configure least-privilege Alibaba Cloud credentials before execution.
- Prefer environment variables:
ALIBABACLOUD_ACCESS_KEY_ID,ALIBABACLOUD_ACCESS_KEY_SECRET, optionalALIBABACLOUD_REGION_ID. - If region is unclear, ask the user before running mutating operations.
References
- Product source APIs: see
references/product-sources.md - OpenAPI meta endpoints: see
references/openapi-meta.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cinience/alicloud-skills/aliyun-openapi-discovery">View aliyun-openapi-discovery on skillZs</a>