T Cloud Public
Use this skill for T Cloud Public, formerly Open Telekom Cloud, infrastructure
inventory, deployment-readiness checks, incident summaries, and guarded DevOps
request planning. Invoke it as t-cloud-public. The helper path uses the
current product name; credential names intentionally keep established OTC_*
identifiers because the public API docs, domains, and customer terminology
still use OTC/Open Telekom Cloud names.
Default Workflow
- Start with read-only inventory or
plan. V1 helper operations are
read/list/describe only.
- Treat
t_cloud_public.cjs as the API wrapper. Do not handcraft OTC API
URLs, service endpoints, signing metadata, request tiers, or SecretRefs from
memory.
- For prompt/user testing, stop after
plan or helper http-request payload
generation. Do not call helper run or the built-in http_request tool.
- For real user requests that need live OTC data, use helper
run. The helper
constructs an allowlisted request and sends it through the HybridClaw gateway
http_request route. For IaaS/API inventory, the gateway resolves
OTC_ACCESS_KEY_ID, OTC_SECRET_ACCESS_KEY, optional OTC_SECURITY_TOKEN,
and OTC_PROJECT_ID, then signs the request server-side.
- Use
http-request only to inspect the generated gateway payload or when
the active runtime cannot give the helper gateway access.
- If a live helper
run or http_request call returns 401, 403, or a
signature/authentication failure, stop after that first failed call. Do not
retry or fan out to more OTC endpoints. Ask the operator to verify
credentials, project ID, region, IAM permissions, and clock skew.
- If a live call returns 429, stop fan-out and report retry guidance from
Retry-After or rate-limit response headers when present.
- For account billing, current spend, charges, and consumption, use the
documented Enterprise Dashboard API v2 through helper operations
billing-daily-consumption and billing-hourly-consumption. These calls use
https://api-enterprise-dashboard.otc-service.com/, bearer secret
OTC_ENTERPRISE_DASHBOARD_TOKEN, and NDJSON responses from
/v2/daily/consumption/ or /v2/hourly/consumption/.
- Mutating actions are outside v1 execution. For create/delete/reboot,
network/security group, volume/backup restore, DNS/load-balancer, IAM/KMS,
database, or container mutations, produce a plan with exact region, project,
resource IDs, intended action, rollback, blast radius, and the required F8/F14
operator approval text. Do not execute the mutation.
- Never paste, print, inspect, or ask for OTC signing material, passwords, API
tokens, AK/SK pairs, project IDs stored as secrets, or session tokens.
- Treat region as plain configuration. Pass
--region eu-de explicitly or
set OTC_REGION=eu-de in the helper environment; do not store region in the
encrypted secret store.
See references/operator-setup.md for operator
setup, credential scope, companion tooling, autonomy defaults, and rate-limit
handling.
Command Contract
Run the helper:
node skills/t-cloud-public/t_cloud_public.cjs --help
Plan without contacting OTC:
node skills/t-cloud-public/t_cloud_public.cjs --format json plan \
"deploy-check for eu-de production"
Build dry-run gateway payloads:
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request regions
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request service-endpoints --region eu-de
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request service-status
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request quotas --region eu-de
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request servers --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request networks --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request volumes --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request cloud-eye-alarms --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request billing-daily-consumption --date 2026-05-24
node skills/t-cloud-public/t_cloud_public.cjs --format json http-request billing-hourly-consumption --date 2026-05-24 --hour 13
Run live read requests through the gateway:
node skills/t-cloud-public/t_cloud_public.cjs --format json run servers --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json run security-groups --region eu-de
node skills/t-cloud-public/t_cloud_public.cjs --format json run backups --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json run rds-instances --region eu-de --limit 50
node skills/t-cloud-public/t_cloud_public.cjs --format json run billing-daily-consumption --date 2026-05-24
Inventory Coverage
- ECS: servers, server details, flavors, quotas
- VPC/network: VPCs, subnets, security groups, EIPs, load balancers
- Storage: EVS volumes, EVS snapshots, Cloud Backup and Recovery backups,
OBS bucket/object listings, SFS shares
- Containers and databases: CCE clusters/nodes and RDS instances
- Observability/audit: Cloud Eye alarms, Cloud Trace events, and Log Tank
Service log groups
- Security/platform checks: IAM regions/projects, IAM service endpoints and
service catalog, public status dashboard checks, KMS keys, WAF policies,
regional endpoints, and service-status oriented readiness summaries
- Billing/spend: Enterprise Dashboard daily and hourly consumption streams.
Parse each NDJSON line, then sum
amount for the requested period.
Readiness Checks
For deployment or incident summaries, gather only the minimum inventory needed:
- region/project/auth readiness without exposing secrets
- quota pressure before deploys
- unhealthy ECS/RDS/CCE resources
- missing recent backups or snapshots
- public EIPs and security groups that expose admin ports
- missing or disabled Cloud Eye alarms
- recent Cloud Trace changes around the incident window
Summaries should be suitable for R29 cards and R32/R33 server-maintenance
handoff: include evidence, region, project, affected resource IDs, recommended
next action, and whether operator approval is needed.
Guarded Operations
All write-like operations are amber/red and require exact F8/F14 approval before
any future write-capable helper may run:
- create/update/delete/reboot compute resources
- modify VPC, security group, EIP, load-balancer, or DNS state
- attach, detach, resize, delete, or restore storage resources
- mutate databases, containers, IAM, KMS, or WAF configuration
The approval text must include target region, project, service, resource IDs,
action, expected blast radius, rollback, and stop conditions. Stop immediately
on authentication failures.
Companion Workflows
Terraform/OpenTofu, Ansible, Cloud Create, official SDKs, Gophercloud, and
python-otcextensions are valid companion workflows for operator-owned changes
and audits. This bundled skill owns its helper contract and should not shell out
to those tools by default.
Validation
python3 skills/skill-creator/scripts/quick_validate.py skills/t-cloud-public
node skills/t-cloud-public/t_cloud_public.cjs --help
node skills/t-cloud-public/t_cloud_public.cjs --format json eval-scenarios
1---2name: t-cloud-public3description: Read T Cloud Public (formerly Open Telekom Cloud) infrastructure inventory and prepare guarded DevOps operations through gateway-managed OTC API signing.4---56# T Cloud Public78Use this skill for T Cloud Public, formerly Open Telekom Cloud, infrastructure9inventory, deployment-readiness checks, incident summaries, and guarded DevOps10request planning. Invoke it as `t-cloud-public`. The helper path uses the11current product name; credential names intentionally keep established `OTC_*`12identifiers because the public API docs, domains, and customer terminology13still use OTC/Open Telekom Cloud names.1415## Default Workflow16171. Start with read-only inventory or `plan`. V1 helper operations are18 read/list/describe only.192. Treat `t_cloud_public.cjs` as the API wrapper. Do not handcraft OTC API20 URLs, service endpoints, signing metadata, request tiers, or SecretRefs from21 memory.223. For prompt/user testing, stop after `plan` or helper `http-request` payload23 generation. Do not call helper `run` or the built-in `http_request` tool.244. For real user requests that need live OTC data, use helper `run`. The helper25 constructs an allowlisted request and sends it through the HybridClaw gateway26 `http_request` route. For IaaS/API inventory, the gateway resolves27 `OTC_ACCESS_KEY_ID`, `OTC_SECRET_ACCESS_KEY`, optional `OTC_SECURITY_TOKEN`,28 and `OTC_PROJECT_ID`, then signs the request server-side.295. Use `http-request` only to inspect the generated gateway payload or when30 the active runtime cannot give the helper gateway access.316. If a live helper `run` or `http_request` call returns 401, 403, or a32 signature/authentication failure, stop after that first failed call. Do not33 retry or fan out to more OTC endpoints. Ask the operator to verify34 credentials, project ID, region, IAM permissions, and clock skew.357. If a live call returns 429, stop fan-out and report retry guidance from36 `Retry-After` or rate-limit response headers when present.378. For account billing, current spend, charges, and consumption, use the38 documented Enterprise Dashboard API v2 through helper operations39 `billing-daily-consumption` and `billing-hourly-consumption`. These calls use40 `https://api-enterprise-dashboard.otc-service.com/`, bearer secret41 `OTC_ENTERPRISE_DASHBOARD_TOKEN`, and NDJSON responses from42 `/v2/daily/consumption/` or `/v2/hourly/consumption/`.439. Mutating actions are outside v1 execution. For create/delete/reboot,44 network/security group, volume/backup restore, DNS/load-balancer, IAM/KMS,45 database, or container mutations, produce a plan with exact region, project,46 resource IDs, intended action, rollback, blast radius, and the required F8/F1447 operator approval text. Do not execute the mutation.4810. Never paste, print, inspect, or ask for OTC signing material, passwords, API49 tokens, AK/SK pairs, project IDs stored as secrets, or session tokens.5011. Treat region as plain configuration. Pass `--region eu-de` explicitly or51 set `OTC_REGION=eu-de` in the helper environment; do not store region in the52 encrypted secret store.5354See [references/operator-setup.md](references/operator-setup.md) for operator55setup, credential scope, companion tooling, autonomy defaults, and rate-limit56handling.5758## Command Contract5960Run the helper:6162```bash63node skills/t-cloud-public/t_cloud_public.cjs --help64```6566Plan without contacting OTC:6768```bash69node skills/t-cloud-public/t_cloud_public.cjs --format json plan \70 "deploy-check for eu-de production"71```7273Build dry-run gateway payloads:7475```bash76node skills/t-cloud-public/t_cloud_public.cjs --format json http-request regions77node skills/t-cloud-public/t_cloud_public.cjs --format json http-request service-endpoints --region eu-de78node skills/t-cloud-public/t_cloud_public.cjs --format json http-request service-status79node skills/t-cloud-public/t_cloud_public.cjs --format json http-request quotas --region eu-de80node skills/t-cloud-public/t_cloud_public.cjs --format json http-request servers --region eu-de --limit 5081node skills/t-cloud-public/t_cloud_public.cjs --format json http-request networks --region eu-de --limit 5082node skills/t-cloud-public/t_cloud_public.cjs --format json http-request volumes --region eu-de --limit 5083node skills/t-cloud-public/t_cloud_public.cjs --format json http-request cloud-eye-alarms --region eu-de --limit 5084node skills/t-cloud-public/t_cloud_public.cjs --format json http-request billing-daily-consumption --date 2026-05-2485node skills/t-cloud-public/t_cloud_public.cjs --format json http-request billing-hourly-consumption --date 2026-05-24 --hour 1386```8788Run live read requests through the gateway:8990```bash91node skills/t-cloud-public/t_cloud_public.cjs --format json run servers --region eu-de --limit 5092node skills/t-cloud-public/t_cloud_public.cjs --format json run security-groups --region eu-de93node skills/t-cloud-public/t_cloud_public.cjs --format json run backups --region eu-de --limit 5094node skills/t-cloud-public/t_cloud_public.cjs --format json run rds-instances --region eu-de --limit 5095node skills/t-cloud-public/t_cloud_public.cjs --format json run billing-daily-consumption --date 2026-05-2496```9798## Inventory Coverage99100- ECS: servers, server details, flavors, quotas101- VPC/network: VPCs, subnets, security groups, EIPs, load balancers102- Storage: EVS volumes, EVS snapshots, Cloud Backup and Recovery backups,103 OBS bucket/object listings, SFS shares104- Containers and databases: CCE clusters/nodes and RDS instances105- Observability/audit: Cloud Eye alarms, Cloud Trace events, and Log Tank106 Service log groups107- Security/platform checks: IAM regions/projects, IAM service endpoints and108 service catalog, public status dashboard checks, KMS keys, WAF policies,109 regional endpoints, and service-status oriented readiness summaries110- Billing/spend: Enterprise Dashboard daily and hourly consumption streams.111 Parse each NDJSON line, then sum `amount` for the requested period.112113## Readiness Checks114115For deployment or incident summaries, gather only the minimum inventory needed:116117- region/project/auth readiness without exposing secrets118- quota pressure before deploys119- unhealthy ECS/RDS/CCE resources120- missing recent backups or snapshots121- public EIPs and security groups that expose admin ports122- missing or disabled Cloud Eye alarms123- recent Cloud Trace changes around the incident window124125Summaries should be suitable for R29 cards and R32/R33 server-maintenance126handoff: include evidence, region, project, affected resource IDs, recommended127next action, and whether operator approval is needed.128129## Guarded Operations130131All write-like operations are amber/red and require exact F8/F14 approval before132any future write-capable helper may run:133134- create/update/delete/reboot compute resources135- modify VPC, security group, EIP, load-balancer, or DNS state136- attach, detach, resize, delete, or restore storage resources137- mutate databases, containers, IAM, KMS, or WAF configuration138139The approval text must include target region, project, service, resource IDs,140action, expected blast radius, rollback, and stop conditions. Stop immediately141on authentication failures.142143## Companion Workflows144145Terraform/OpenTofu, Ansible, Cloud Create, official SDKs, Gophercloud, and146`python-otcextensions` are valid companion workflows for operator-owned changes147and audits. This bundled skill owns its helper contract and should not shell out148to those tools by default.149150## Validation151152```bash153python3 skills/skill-creator/scripts/quick_validate.py skills/t-cloud-public154node skills/t-cloud-public/t_cloud_public.cjs --help155node skills/t-cloud-public/t_cloud_public.cjs --format json eval-scenarios156```