CLAUDE.md git:20260524.2f5e189A

Immutable. This exact content is served forever at /api/v1/blob/8f7846db7684e967.

# 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/`.
- **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 four places: `skills/`, `qa/`, `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`.