# SemanticSkills

Community skills monorepo — not official Huawei Cloud.

## Do not get wrong

- **`skills/<name>/` = install payload only** (`npx skills add` copies this tree). Put gates, evals, and `skillcheck.toml` under **`qa/<name>/`** (`validate.sh` → `bin/gate.py full`); never inside `skills/`.
- **Skill Creator eval output:** `<name>-workspace/` at **repo root only** (gitignored). Never under `skills/` — `npx skills add` would ship it. Run evals from repo root so paths resolve to `./<name>-workspace/`.
- **Do not edit or commit:** `.agents/`, `*-workspace/`, `.workspaces/`, `.credentials/`, gate reports.
- **Done means** `./qa/<name>/validate.sh` (or `./tools/validate-all.sh`) passes — say so only after running it.
- **Skill change** syncs five places: `skills/`, `qa/` (`VERSION`, `CHANGELOG.md`), `docs/catalog.yml`, `docs/skills/<name>.md`. New skill: `./tools/skill-scaffold.sh <name>`.
- **Routing** is by fact / dimension / measure / time / scope — not FAQ lists. BSS operation change → update `references/semantic/*.yml`, `related-commands.md`, and `qa/.../fixtures/ops_contracts.yml` together.
- **No commit** unless asked. Never commit `.env*`, AK/SK, or credential files. Minimal diffs; no extra markdown unless asked.

## huawei-cloud-billing-scout

- **Read-only BSS** — refuse pay, renew, refund, delete, update, create. `ListCustomer*ChangeRecords` are read ledgers (`Change` ≠ write).
- No auto-install `hcloud`. Real BSS calls only when `HUAWEICLOUD_BILLING_SCOUT_REAL=1`.