| name | cowork-api |
| description | Upload, import, deploy, publish, register, send or push agent, skill or plugin bundles to Stratio Cowork (`genai-api`). Use when the user asks to upload/import/deploy/publish/register a packaged agent, skill or plugin ZIP to Cowork — including phrases like 'súbelo', 'deploy this', 'impórtalo', 'publica el agente', 'regístralo en Cowork', 'sube el plugin'. Calls `/v1/agents/bundle/import` and `/v1/agents/skills/bundle/import` (plugins dispatch to both). |
Skill: Stratio Cowork management API (genai-api)
Router skill. Each capability lives in its own file under tasks/. This file is intentionally minimal — when the agent needs to perform a specific task, it must load and follow the corresponding sub-file in full. Do not improvise the request from this index.
Prerequisites — read first
Before any call, follow guides/external-api-calls.md:
- §1 lists the environment variables and certificate paths the sandbox provides.
- §2 has the standard pre-check (
preflight_external_api). Run it; if it fails, stop and report to the user which prerequisites are missing (env vars or certificate paths) — the operation cannot proceed without a healthy environment. Surface the missing pieces explicitly; do not refuse with a generic message.
- §3 and §4 are the curl / Python templates. Each task below picks one and only adds the endpoint-specific bits (path, multipart field, query params).
- §5 is the error table to use when surfacing failures back to the user.
GENAI_API_URL (env var) is the base URL of the API. All endpoints below are relative to it.
Capability index
| Capability | When to use | Sub-file to load |
|---|
| Upload a skill bundle | The user has packaged a skill into a ZIP and wants it registered in Stratio Cowork. | tasks/upload-skill.md |
| Upload an agent bundle | The user has packaged an agent (agents/v1 container ZIP) and wants it registered in Stratio Cowork. | tasks/upload-agent.md |
| Upload a plugin bundle | The user has packaged a functional plugin (wrapper ZIP that contains agent and/or skill sub-ZIPs plus an aggregated plugin.yaml) and wants it registered in Stratio Cowork. | tasks/upload-plugin.md |
Routing rules
- Identify the capability from the user's intent. If none of the entries above matches, this skill cannot help — say so.
- Run the pre-check from
guides/external-api-calls.md §2. If it fails, stop and report.
- Load the matching sub-file and follow it end-to-end. Do not blend instructions across sub-files.
- After the call, surface the HTTP code and response body to the user as described in
guides/external-api-calls.md §5.
Adding a new capability
To extend this skill with a new operation against genai-api:
- Create
tasks/<capability>.md with: when to use, endpoint (method + path + content type), required and optional parameters, ready-to-run command, expected response, error cases specific to this endpoint.
- Add an entry to the Capability index above.
- Mirror both files under
es/skills/cowork-api/.
The sub-file is the source of truth for its capability. The index above is just routing.
