monospace
Installation
SKILL.md
Monospace
Work with a Monospace instance: query and mutate data through the REST API or the typed SDK, generate instance-specific types, bootstrap workspaces and discover schema, and use the per-workspace MCP server. Read the traps below, then load the reference that matches the task.
Verified against engine source 4f6f48c (reports 0.7.0) with @monospace/sdk 0.8.0 and @monospace/cli 0.1.0 from continuous build 31d52d0. Monospace is in early access. If an instance behaves differently, trust the instance and its error messages.
Principles
- Don't guess the API. Monospace has a different API and SDK from Directus. The sources of truth are the types generated from the instance (
monospace sdk generate), the instance's own responses and error messages, and these references. The workspace OpenAPI document describes item routes (use it for payload shapes and codegen). It is not a complete or fully correct catalog of management and schema routes, so use bootstrap-and-schema.md for those. - Generate types, then write against them. Examples here use illustrative collection and field names, so adapt names and types to the generated schema.
- Inspect, write, verify. Read the schema and existing rows before writing. Send an explicit
fieldsselection on item reads and writes. Afterwards, read back using the same key or the user's exact filter. - Recover, don't loop. Read the error body, including its nested
sourcechain. After 2–3 failed attempts, re-check the schema, permissions, and license instead of retrying.