{"skill":{"slug":"alicloud-platform-docs-api-review","displayName":"Alicloud Platform Docs Api Review","summary":"Automatically review latest Alibaba Cloud product docs and OpenAPI docs by product name, then output detailed prioritized improvement suggestions with eviden...","description":"---\nname: alicloud-platform-docs-api-review\ndescription: Automatically review latest Alibaba Cloud product docs and OpenAPI docs by product name, then output detailed prioritized improvement suggestions with evidence and scoring. Use when user asks to audit product documentation quality, API documentation quality, or wants actionable doc/API optimization recommendations.\nversion: 1.0.0\n---\n\n# Alibaba Cloud Product Docs + API Docs Reviewer\n\nUse this skill when the user gives a product name and asks for an end-to-end documentation/API quality review.\n\n## What this skill does\n\n1) Resolve product from latest OpenAPI metadata.\n2) Fetch latest API docs for default version.\n3) Discover product/help-doc links from official product page.\n4) Produce a structured review report with:\n- score\n- evidence\n- prioritized suggestions (P0/P1/P2)\n\n## Workflow\n\nRun the bundled script:\n\n```bash\npython skills/platform/docs/alicloud-platform-docs-api-review/scripts/review_product_docs_and_api.py --product \"<product name or product code>\"\n```\n\nExample:\n\n```bash\npython skills/platform/docs/alicloud-platform-docs-api-review/scripts/review_product_docs_and_api.py --product \"ECS\"\n```\n\n## Output policy\n\nAll generated artifacts must be written under:\n\n`output/alicloud-platform-docs-api-review/`\n\nFor each run, the script creates:\n\n- `review_evidence.json`\n- `review_report.md`\n\n## Reporting guidance\n\nWhen answering the user:\n\n1) State resolved product + version first.\n2) Summarize the score and the top 3 issues.\n3) List P0/P1/P2 recommendations with concrete actions.\n4) Provide source links used in the report.\n\n## Validation\n\n```bash\nmkdir -p output/alicloud-platform-docs-api-review\nfor f in skills/platform/docs/alicloud-platform-docs-api-review/scripts/*.py; do\n  python3 -m py_compile \"$f\"\ndone\necho \"py_compile_ok\" > output/alicloud-platform-docs-api-review/validate.txt\n```\n\nPass criteria: command exits 0 and `output/alicloud-platform-docs-api-review/validate.txt` is generated.\n\n## Output And Evidence\n\n- Save artifacts, command outputs, and API response summaries under `output/alicloud-platform-docs-api-review/`.\n- Include key parameters (region/resource id/time range) in evidence files for reproducibility.\n\n## Prerequisites\n\n- Configure least-privilege Alibaba Cloud credentials before execution.\n- Prefer environment variables: `ALICLOUD_ACCESS_KEY_ID`, `ALICLOUD_ACCESS_KEY_SECRET`, optional `ALICLOUD_REGION_ID`.\n- If region is unclear, ask the user before running mutating operations.\n\n## References\n\n- Review rubric: `references/review-rubric.md`\n","topics":["Docs","Documentation"],"tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":1065,"installsAllTime":40,"installsCurrent":2,"stars":0,"versions":2},"createdAt":1770973225049,"updatedAt":1778488088696},"latestVersion":{"version":"1.0.1","createdAt":1773222016942,"changelog":"batch publish from alicloud-skills on 2026-03-11","license":"MIT-0"},"metadata":null,"owner":{"handle":"cinience","userId":"s1707avh05gnzr3g6e3m9ka6fh840rtd","displayName":"cinience","image":"https://avatars.githubusercontent.com/u/557426?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779973238824}}