Install
openclaw skills install @huaweiclouddev/huawei-cloud-skill-creator1. Six-phase pipeline for creating Huawei Cloud skills — Socratic requirements gathering, CLI→SDK→API research, MD generation, test preparation, detailed testing, and final cleanup & compliance check 2. Phase-chained dependency: each phase builds on the previous phase's output, no phase may be skipped 3. Supports CLI, SDK, and REST API execution modes with automatic fallback detection 4. Generates complete skill directory structure with SKILL.md, references/, scripts/, templates/ 5. Validates against the Huawei Cloud Skill Specification (华为云Skill检查规范) Triggers include: "创建华为云Skill","新建华为云Skill","华为云skill创建器","创建 Skill","新建 Skill","skill 创建器","create skill","build skill","new skill","skill creator","scaffold a Huawei Cloud skill","wrap CLI or OpenAPI into a skill","package cloud operations into a skill","帮我创建华为云Skill","帮我新建一个Skill","封装华为云CLI为Skill","华为云Skill脚手架","帮我创建一个skill","我需要一个skill","建一个skill","生成skill","帮我建一个华为云skill".
openclaw skills install @huaweiclouddev/huawei-cloud-skill-creatorSix-Phase Strict Pipeline — Each phase depends on the previous phase's output and cannot be skipped. If any phase is missing, restart from the missing phase.
The Huawei Cloud Skill Creator v2 is based on a six-phase strict pipeline: starting with Socratic Q&A requirements analysis, followed by technical research (CLI→SDK→API three-level fallback), document generation, test preparation, detailed testing, resource cleanup and compliance check, ultimately generating a complete skill package that conforms to the Huawei Cloud Skill Specification.
huaweicloudsdk packages available — SDK Reference: https://console.huaweicloud.com/apiexplorer/#/sdkcenterHUAWEI / HW / HWC 开头的环境变量,匹配其中含 ACCESS_KEY / _AK / SECRET_KEY / _SK 的键值对Phase 1 (Q&A) → Phase 2 (Tech Research) → Phase 3 (Generate MD)
→ Phase 4 (Test Prep) → Phase 5 (Detailed Testing) → Phase 6 (Cleanup & Report)
Strict Rules:
Goal: Clarify user requirements through question-by-question dialogue.
Output: phase-1-summary.json — User-confirmed requirements description
Dependency: Phase 1 requirements analysis completed (phase-1-summary.json exists)
For each feature point confirmed in Phase 1, research availability in the following order:
| Priority | Research Method | Verification Command | Success Criteria |
|---|---|---|---|
| 1st | CLI — hcloud command | hcloud <Service> <Operation> --cli-region=cn-north-4 --help | Command exists and parameters are valid |
| 2nd | SDK — huaweicloudsdk | python3 -c "from huaweicloudsdk{service}.v2 import ..." | SDK package installed and class importable |
| 3rd | API — Only from the following two sources | See rules below | Endpoint from a trusted source, not inferred |
Core Rule: API Endpoint Forensics (No Guessing)
API endpoints are only allowed from the following two sources. Strictly prohibited from inferring through naming patterns:
| Trusted Source | Method |
|---|---|
① SDK source _http_info resource_path | grep -A8 "_http_info" {service}_client.py → Read resource_path value |
| ② Huawei Cloud API Explorer (api-explorer.huaweicloud.com) | User searches and confirms on that website |
❌ Strictly prohibited actions:
_http_info → Mark ⛔, do not inferExecution Rules:
Research feature point N
├── CLI available → Record as CLI mode, record specific command
├── CLI unavailable → Check SDK
│ ├── SDK available → Record as SDK mode
│ │ ├── Read all _http_info methods from SDK source to obtain real REST paths
│ │ │ grep "resource_path" <sdk_path>/{service}_client.py
│ │ └── Feature point's corresponding method has _http_info in SDK → Record real API endpoint
│ │ Feature point's corresponding method has no _http_info in SDK → Mark ⛔, do not infer
│ ├── SDK unavailable → Ask user to confirm endpoint from API Explorer
│ │ ├── User finds endpoint from API Explorer → Record as API mode, note the source
│ │ ├── User provides endpoint (other source) → Record as API mode, mark ⚠ user-provided
│ │ └── User cannot provide → Mark ⛔
│ └── SDK partially available (some methods missing and no corresponding _http_info) → Mark missing features as ⛔
└── Generate feature point research result (including execution mode + real API path if available)
🛑 Agent is strictly forbidden from guessing/fabricating API paths on its own. If neither the SDK source nor API Explorer has the endpoint, mark it ⛔ — it doesn't exist.
Tips for finding SDK client source paths:
# Method 1: Find package installation path
python3 -c "import huaweicloudsdk{service}.v2 as m; import os; print(os.path.dirname(m.__file__))"
# Method 2: Find all _http_info methods (show all API endpoints)
grep "_http_info" <path>/{service}_client.py
# Method 3: View API path for a specific method
grep -A8 "_{method}_http_info" <path>/{service}_client.py
# The "resource_path" key in output is the real REST endpoint
Output: phase-2-summary.json — Execution mode (CLI/SDK/API/⛔) and corresponding command/code/API path for each feature point
Dependency: Phase 2 technical research completed (phase-2-summary.json exists)
Generate Skill files based on Phase 2 conclusions:
Name the Skill — huawei-cloud-{product}-{function} format
Language — Generate SKILL.md in English by default. Chinese documentation may be added in references/ as supplementary. The main SKILL.md must use English for frontmatter description, section titles, command examples, and all explanatory content.
Create directory structure:
skills/{category}/{skill-name}/
├── SKILL.md
├── references/
│ ├── iam-policies.md (Required)
│ ├── verification-method.md (Recommended)
│ ├── dataflow-diagram.md (Recommended)
│ └── acceptance-criteria.md (Recommended)
├── scripts/
│ └── test-cli-commands.sh
├── templates/
│ └── test-vars.json
SKILL.md content generation rules:
| Execution Mode | Command Format in SKILL.md |
|---|---|
| CLI | hcloud <Service> <Operation> --cli-region={region} [--params] |
| SDK | Python script example (python3 -c "...") |
| API | curl command + user-provided endpoint (mark ⚠ user-provided) |
| ⛔ | Mark requires manual verification, do not generate specific commands |
Required sections in SKILL.md (per specification):
| Section | Severity | Description |
|---|---|---|
| YAML Frontmatter | Critical | name + description (including Triggers include:) + tags |
| Overview | High | Feature overview, architecture, applicable scenarios |
| Prerequisites | High | CLI version, authentication config, IAM permissions |
| Workflow | High | Phase 1-6 process steps |
| KooCLI Command Format Standard | High | General CLI command format specification (service name/operation name/parameter syntax) |
| Core Commands | High | Command examples grouped by function |
| Parameter Confirmation | High | User-configurable parameter table |
| Reference Documents | Critical | Links to documents under references/ |
| IAM Permissions | Critical | references/iam-policies.md |
Generate Mermaid data flow diagram → references/dataflow-diagram.md
Generate IAM policies → references/iam-policies.md (principle of least privilege)
Generate reference materials: If Phase 2 discovered API paths through SDK source, organize them into references/api-paths.md
File size constraint: Total skill directory size must not exceed 40 MB. Run du -sh {skill-dir} to verify after generation.
File extension constraint: All generated files must use one of the following allowed extensions:
.md, .sh, .bash, .ps1, .py, .json, .yaml, .yml, .toml, .txt, .png, .jpg, .jpeg, .svg, .css, .js, .lock, .gitkeep, .pdf, .drawio.
Any file with an extension not in this list must be removed or renamed before the skill is considered complete.
File count constraint: Total number of files in the skill directory must not exceed 30 (including SKILL.md, all files under references/, scripts/, templates/, and any other subdirectories). Count with find {skill-dir} -type f | wc -l.
🛑 Strictly prohibited from generating hallucinated URIs / fabricated API paths. Feature points not verified in Phase 2 must not have specific commands written.
Output: phase-3-summary.json — List of generated files and structure validation results
Dependency: Phase 3 document generation completed (phase-3-summary.json exists)
Generate test cases — Split test cases based on Phase 2/3 feature points
| Case Type | Coverage Requirement | Example |
|---|---|---|
| CLI cases | One case per hcloud command | hcloud ECS ListServers --limit=1 |
| SDK cases | One case per SDK call | list_sub_customer_coupons(limit=1) |
| API cases | One case per user-provided endpoint | curl -X GET {endpoint} |
Save test cases as JSON → templates/test-vars.json
{
"test_cases": [
{"id": "TC-01", "name": "...", "command": "...", "expected": "..."},
...
]
}
Show all test cases to the user for confirmation
Run tests:
HUAWEI / HW / HWC 开头的环境变量,匹配其中含 ACCESS_KEY / _AK / SECRET_KEY / _SK 的键值对Test verification flow:
Each case → Try CLI execution
├── ✅ Success → Record PASS
└── ❌ Failure → Check syntax issues
├── ✅ Syntax issue → Fix and retry
└── ❌ Non-syntax issue → Fallback to SDK
├── ✅ Success → Record PASS (SDK)
└── ❌ Failure → Fallback to API (user-provided endpoint)
├── ✅ Success → Record PASS (API)
└── ❌ Failure → Record FAIL ⛔ requires manual verification
Output: phase-4-summary.json — Test case list + per-case execution results
Dependency: Phase 4 test preparation completed (phase-4-summary.json exists)
Full regression: Execute all test cases generated in Phase 4
Resource lifecycle testing (applicable to Skills involving resource creation/modification/deletion):
Management-type Skills:
Report generation:
Output: phase-5-summary.json — Detailed test results + resource operation records
Dependency: Phase 5 detailed testing completed (phase-5-summary.json exists)
Resource Cleanup:
Huawei Cloud Skill Specification Compliance Check (against 华为云Skill检查规范):
| Check Item | Level | Verification Method |
|---|---|---|
| SKILL.md exists | Critical | File existence check |
| Skill directory under skills/ | Low | Path format: skills/{category}/{subcategory}/{skill-name}/ |
| Skill package naming convention | High | Directory name matches huawei-cloud-{product}-{function} |
| One PR submits only one Skill | Critical | git diff checks that PR changes only affect a single Skill directory |
| YAML Frontmatter exists | Critical | grep '^---$' |
| name field exists | Critical | Frontmatter name field exists and matches directory name |
| description field exists | Critical | Frontmatter description field exists and contains feature summary + trigger words |
| description includes trigger words | Medium | grep 'Triggers include:' |
| Should not contain version field | Low | No version field in frontmatter |
| Overview section | High | grep '##.*概述' |
| Prerequisites section | High | grep '##.*前置条件' |
| Workflow section | High | grep '##.*工作流' |
| Core Commands section | High | grep '##.*核心命令' |
| Parameter Confirmation section | High | grep '##.*参数确认' |
| Reference Documents section | Critical | grep '##.*参考文档' |
| KooCLI Command Format Standard section | Low | Required when CLI is involved, grep '##.*KooCLI.*命令格式' |
| references/cli-installation-guide.md | High | Required when CLI is involved, file existence |
| references/iam-policies.md | Critical | File existence |
| references/verification-method.md | Medium | Recommended file existence |
| references/acceptance-criteria.md | Low | Recommended file existence |
| Reference document kebab-case naming | Low | File names under references/ are all lowercase kebab-case |
| Credential hardcoding | Critical | grep for credential hardcoding patterns and CLI credential config |
| Cross-Skill direct calls | Critical | grep other Skill names |
| CLI write operations require confirmation | Low | Check whether user confirmation is prompted |
| Service name requirement | Medium | hcloud service names follow KooCLI Services (uppercase/title case) |
| Operation name PascalCase | Medium | Operation names use PascalCase |
| Includes --cli-region | Medium | Whether CLI commands include --cli-region parameter |
Run skill_audit.py on the generated Skill, performing the following five security and quality checks:
| # | Tool | Check Content | Severity | Installation |
|---|---|---|---|---|
| 1 | skillcheck | SKILL.md agentskills.io specification validation (frontmatter fields, description quality, reference safety) | WARNING/ERROR | pip install skillcheck |
| 2 | markdownlint-cli2 | Markdown style consistency (line length, duplicate headings, code block formatting, etc.) | ERROR | npm install -g markdownlint-cli2 |
| 3 | cisco-ai-skill-scanner | AI security scan: command injection, reverse shell, credential leakage, dangerous functions, prompt injection | CRITICAL/HIGH | pip install cisco-ai-skill-scanner (CLI: skill-scanner) |
| 4 | hwcloud-spec | Huawei Cloud SKILL.md specification check: frontmatter required fields, section structure, file size | ERROR/WARNING | Built-in (hwcloud_spec_check.py) |
| 5 | gitleaks | Credential leak scan: detects hardcoded API keys, passwords, private keys, tokens, and 800+ other patterns | ERROR | Download from GitHub Releases |
Specification Security Scan Four Checks (Huawei Cloud Skill Specification Part 2):
| # | Specification Check | Level | Coverage Tool | Coverage Description |
|---|---|---|---|---|
| 1 | Secret leak detection | Critical | gitleaks + skill-scanner | AK/SK hardcoding, CLI credential config, report output masking |
| 2 | Vulnerability pattern detection | Critical | skill-scanner | Known vulnerability code pattern matching (command injection, reverse shell, etc.) |
| 3 | Dependency security detection | Critical | ⚠️ Requires additional tools | Known unsafe dependency version detection, recommended to integrate pip audit or safety check |
| 4 | Insecure configuration detection | Critical | skill-scanner | Insecure protocols, weak password configuration, etc. |
Execution method:
python3 scripts/skill_audit.py --target {skill-path}
Security audit flow:
Run skill_audit.py → Generate skill-gate-report-<timestamp>.txt
├── Gate Verdict: PASS → ✅ Audit passed, proceed to next step
└── Gate Verdict: FAIL → Fix issues item by item per Report Section 4
├── skillcheck issues → Fix frontmatter/description/references
├── markdownlint issues → First run markdownlint-cli2 --fix for auto-fix
│ → Then manually fix non-auto-fixable items (MD036/MD040, etc.)
├── skill-scanner issues → Command injection/reverse shell → Move to scripts/ reference
│ → Credential leakage → Replace with environment variable reference
├── hwcloud-spec issues → Add missing sections/fields
├── gitleaks issues → Replace hardcoded credentials with environment variables
├── Dependency security detection → Run pip audit / safety check, fix unsafe dependency versions
└── After fixing, rerun skill_audit.py → Until PASS
Security audit result handling:
| Audit Result | Action |
|---|---|
| PASS (0 issues) | Record in phase-6-summary.json, proceed to step 4 |
| PASS (WARNINGs only) | Record WARNINGs in phase-6-summary.json, prompt user to confirm acceptance, proceed to step 4 |
| FAIL (has ERROR/CRITICAL) | Must fix and re-audit, cannot skip |
🛑 When the security audit does not pass, declaring the Skill creation complete is strictly prohibited. CRITICAL/ERROR level issues must be fixed.
Final report:
Final six-phase completeness check:
Check phase-1-summary.json exists → If missing, restart from Phase 1
Check phase-2-summary.json exists → If missing, restart from Phase 2
Check phase-3-summary.json exists → If missing, restart from Phase 3
Check phase-4-summary.json exists → If missing, restart from Phase 4
Check phase-5-summary.json exists → If missing, restart from Phase 5
Check phase-6-summary.json exists → If missing, restart from Phase 6
All phases complete → Creation done. Missing phases → Restart from the missing phase.
Clean up phase summary files: After completeness check passes, delete all phase-*-summary.json files under the skill directory
# Execute after final completeness check passes
# Safety check: ensure skill-path is a legitimate directory under the expected path
[ -d "{skill-path}" ] && [ -f "{skill-path}/SKILL.md" ] && rm -f {skill-path}/phase-*.json
echo "✅ phase-1~6-summary.json cleanup complete"
Note: Only perform cleanup after the completeness check fully passes. If there are missing phases, do not clean up; restart from the missing phase.
Output: phase-6-summary.json — Final creation report + compliance check results + security audit conclusion
hcloud <Service> <Operation> --cli-region=<region> [--key=value ...]
| Feature | Description | Example |
|---|---|---|
| Service name | Uppercase PascalCase | ECS, VPC, IAM |
| Operation name | PascalCase | ListServers, ShowServer |
| Region parameter | --cli-region=<value> | --cli-region=cn-north-4 |
| Simple parameter | --key=value | --server_id=xxx |
| Indexed parameter | --key.1=value1 | --servers.1.id=xxx |
| Command | Purpose |
|---|---|
bash scripts/validate-skill.sh {path} | Phase 3/6: Structure validation + spec check + security audit |
bash scripts/test-cli-commands.sh {path} --executor {cli|sdk|api} | Phase 4/5: Functional testing |
python3 scripts/skill_audit.py --target {path} | Phase 6: Five-item security audit (skillcheck+markdownlint+skill-scanner+hwcloud-spec+gitleaks) |
| Parameter | Required | Description | Example |
|---|---|---|---|
{skill-path} | Yes | Target Skill directory path | e.g., huawei-cloud-ecs-manage |
{region} | No | Huawei Cloud region | cn-north-4 |
{executor} | No | Execution mode (cli/sdk/api) | cli |
| Scenario | Handling |
|---|---|
| User skips questions and says "start" directly | Remind: requirements analysis must be completed first, start from Phase 1 questions |
| AK/SK environment variables not set | Prompt user to provide AK/SK; if user does not provide, terminate process, strictly prohibited from skipping |
| Target service not supported by hcloud CLI | Phase 2 fallback to SDK → Read SDK source _http_info → If still not found, mark ⛔ |
| SDK package does not exist | Check package name variants, if still not found, inform user, do not infer API |
| User is unsure of API endpoint | Mark ⛔ requires manual verification, do not fabricate endpoints. If SDK has the method, read _http_info for the real path |
| SDK has method but _http_info has no resource_path | Mark ⛔, this API does not exist in the SDK, do not infer |
| Attempting to infer API via path pattern (e.g., inferring claim-vouchers from coupons) | ❌ Strictly prohibited. It doesn't exist |
| Resource creation test fails | Analyze error cause (permissions/quota/parameters) → Fix and retry |
| Resource release fails | Retry 3 times, if still failing, inform user to clean up manually |
| User refuses resource lifecycle testing | Inform user: resource lifecycle testing is a required step and cannot be skipped; if user still refuses, terminate process |
| Phase 6 finds missing phases | Restart from the missing phase until all 6 phases are complete |
| SDK has method but actual API path unknown | Read SDK source grep _http_info {service}_client.py to get real path |
| BSS service SDK initialization fails (GlobalCredentials) | See references/bss-sdk-notes.md: BSS must use GlobalCredentials + with_endpoints, not BasicCredentials + with_region |
| list_sub_customer_coupons query returns 400 | BSS limit parameter maximum is 100, not the default 200 |
| Phase 6 security audit FAIL | Fix issues item by item per skill-gate-report Section 4, rerun skill_audit.py after fixing |
| skill-scanner false positive | Use <!-- skill-scanner:ignore --> comment annotation, or exclude in .secrets.baseline |
| gitleaks false positive | Add to .gitleaksignore file |
bash scripts/validate-skill.sh {skill-path}
# Check against 华为云Skill检查规范 item by item
bash scripts/test-cli-commands.sh {skill-path} --executor cli # CLI priority
bash scripts/test-cli-commands.sh {skill-path} --executor sdk # SDK fallback
bash scripts/test-cli-commands.sh {skill-path} --executor api # API fallback
Final verification: Check whether phase-1-summary.json ~ phase-6-summary.json exist
All exist ✅ → Creation complete
Missing any ❌ → Restart from the missing phase
# Run five security checks
python3 scripts/skill_audit.py --target {skill-path}
# If FAIL, fix per report and rerun
# Auto-fix markdownlint issues
markdownlint-cli2 "{skill-path}/**/*.md" --config "{skill-path}/.markdownlint.json" --fix
# Re-audit
python3 scripts/skill_audit.py --target {skill-path}
references/cli-installation-guide.md — CLI installation and configurationreferences/iam-policies.md — Least-privilege IAM policiesreferences/verification-method.md — Verification method detailsreferences/dataflow-diagram.md — Mermaid data flow diagramreferences/acceptance-criteria.md — Acceptance criteriareferences/related-commands.md — Command quick referencereferences/api-paths.md — (Optional) REST API paths discovered via SDK source in Phase 2references/bss-sdk-notes.md — BSS service SDK initialization guide (GlobalCredentials + with_endpoints), reference when creating voucher/billing-related Skillsreferences/security-audit-guide.md — Phase 6 security audit guide (usage and fix strategies for the five skill-targeted-audit checks)_http_info to get real API paths; strictly prohibited from inferring_http_info or Huawei Cloud API Explorer; strictly prohibited from inferring via naming patterns_http_info or Huawei Cloud API Explorer; strictly prohibited from guessing via naming patterns