← ClaudeAtlas

inkwelllisted

inkwell/v2 YAML schema — apiVersion, kind, spec.scaling, spec.healthcheck, spec.limits — exact field names and integer value types for inkwell service configuration; fields include min, max, metric, rps, target, path, interval, threshold, burst
itlackey/akm · ★ 46 · AI & Automation · score 70
Install: claude install-skill itlackey/akm
# inkwell inkwell is a service configuration system. Services are defined in YAML files conforming to the `inkwell/v2` schema. ## Basic structure ```yaml apiVersion: inkwell/v2 kind: Service metadata: name: <service-name> spec: runtime: image: <image>:<tag> port: <port-number> ``` `apiVersion` must be exactly `inkwell/v2`. `kind` must be `Service`. ## runtime The `spec.runtime` block defines the container image and listening port. ```yaml spec: runtime: image: myapp:v1.2.3 port: 8080 ``` ## scaling The `spec.scaling` block controls autoscaling. `metric` is one of: `cpu`, `memory`, `rps` (requests per second). `target` is a percentage for `cpu`/`memory`, or an integer request count for `rps`. ```yaml spec: scaling: min: 2 max: 20 metric: rps target: 100 ``` For CPU at 65% utilization: ```yaml spec: scaling: min: 1 max: 8 metric: cpu target: 65 ``` **EXACT field values:** `metric: rps` (not `requests_per_second` or `request-rate`). `target` is a plain integer — no unit suffix (`100` not `100rps` or `"100"`). ## healthcheck The `spec.healthcheck` block configures the HTTP health probe. `interval` is plain integer seconds — no unit suffix. `threshold` is the number of consecutive checks before state change. ```yaml spec: healthcheck: path: /health interval: 10 threshold: 3 ``` Note: `interval` is `10` not `"10s"`. `threshold` not `failureThreshold`. ## limits The `spec.limits` block sets req