alicloud-platform-openapi-product-api-discovery
Discover and reconcile 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 alicloud-platform-openapi-product-api-discoveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates the discovery and cataloging of Alibaba Cloud products and their associated APIs. It leverages official Alibaba Cloud metadata endpoints and the aliyun-python-sdk-core library to gather product codes, versions, and API documentation. The skill follows security best practices by utilizing environment variables for credential management and restricting all file outputs to a local directory.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
6/13 files flagged
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/alicloud-platform-openapi-product-api-discovery
for f in skills/platform/openapi/alicloud-platform-openapi-product-api-discovery/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-platform-openapi-product-api-discovery/validate.txt
Pass criteria: command exits 0 and output/alicloud-platform-openapi-product-api-discovery/validate.txt is generated.
Output And Evidence
- Save artifacts, command outputs, and API response summaries under
output/alicloud-platform-openapi-product-api-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:
ALICLOUD_ACCESS_KEY_ID,ALICLOUD_ACCESS_KEY_SECRET, optionalALICLOUD_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/alicloud-platform-openapi-product-api-discovery">View alicloud-platform-openapi-product-api-discovery on skillZs</a>