inkwelllisted
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