How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/wazootech/wazoo-skills --skill wazooBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Wazoo Skill
Use this skill when interacting with the Wazoo platform, managing knowledge graph worlds, querying structured memory, or maintaining durable agent context.
Environment setup
Wazoo uses two token types:
WAZOO_PLATFORM_TOKEN(wzp_...): Control plane management (worlds, tokens,
usage, billing).
WORLDS_TOKEN(wzw_...): Data plane operations (import, search, SPARQL,
export).
export WAZOO_PLATFORM_TOKEN="wzp_..."
export WORLDS_TOKEN="wzw_..."1. Control plane management
List worlds
curl -s -X GET "https://api.wazoo.dev/v1/worlds" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"Create a world
Create a world with a display name. worlds-api mints one immutable w_<ULID> ID. The create request has display-name and optional-region fields, with no caller-selected ID or slug field. The response exposes the ID as world.id; reuse it unchanged as WORLD_ID.
curl -s -X POST "https://api.wazoo.dev/v1/worlds" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"world": { "displayName": "Project Context Graph", "region": "auto" }
}'For the examples below, replace this sample with the id returned above:
export WORLD_ID="w_01jd8x5mqv7k3n9r2t4w6y8z0b"Get world details
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"Update a world
curl -s -X PATCH "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"updateMask": "displayName",
"world": { "displayName": "Project Context Graph v2" }
}'Delete a world
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"Undelete a world
Deletes are soft and recoverable. Restore a deleted world with undelete:
curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/undelete" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"2. Token management
List platform tokens
curl -s -X GET "https://api.wazoo.dev/v1/auth/api-tokens" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"Create a platform token
curl -s -X POST "https://api.wazoo.dev/v1/auth/api-tokens" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "my-agent-token",
"scope": "users.read worlds.read usage.read"
}'Revoke a platform token
curl -s -X DELETE "https://api.wazoo.dev/v1/auth/api-tokens/my-agent-token" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"List world tokens
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"Create a world token
World tokens are scoped to a single world for data-plane access:
curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "ci-data-access" }'Revoke a world token
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens/{tokenUid}" \
-H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"3. Data plane operations
Import graph data
Import RDF quads (JSON array) or chunk text into a world:
curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/import" \
-H "Authorization: Bearer $WORLDS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contentType": "text/plain",
"data": "Architectural Decision Record 001: Use hybrid SPARQL and vector search for durable memory."
}'Hybrid search across context
Search world graph memory by query text:
curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/search" \
-H "Authorization: Bearer $WORLDS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "Architectural Decision Record",
"limit": 5
}'Execute SPARQL query
Run graph queries over triples/quads in the world:
curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/sparql" \
-H "Authorization: Bearer $WORLDS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10"
}'Export graph data
Export world quads for auditing or local backup:
curl -s -X GET "https://data.wazoo.dev/worlds/$WORLD_ID/export?format=application/json&limit=100" \
-H "Authorization: Bearer $WORLDS_TOKEN"