{"id":63048,"plugin_id":"plugin_asdk_app_6ac7a64cdefc81918e536775e2ce2d47","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-27T00:52:45.520Z","digest":"f621075bbd41db71854e756f0d88b7eb25d391ce276fcee9509c7b492b9eb8ad","against":null,"payload":{"description":"Work safely with Vaiz AI agents — recognise agent members (isAgent true), learn what each agent does with list_agents, confirm with the user before assigning or mentioning one, report whether the agent run started, and review past runs.","included_files":[],"name":"vaiz-agents","skill_md_contents":"---\nname: vaiz-agents\ndescription: Work safely with Vaiz AI agents — recognise agent members (isAgent true), learn what each agent does with list_agents, confirm with the user before assigning or mentioning one, report whether the agent run started, and review past runs.\n---\n\n# Vaiz AI agents\n\nA Vaiz space can have AI agents: configured automations that act on their own inside their project/board scope. Each agent is also a member of the space, so it shows up next to people and is assigned or mentioned by its member id. It is not a person: never treat an agent as a teammate who will \"pick up\" a task.\n\n## Prerequisite\n\nThe Vaiz MCP server (`https://api.vaiz.com/mcp`) must be available through the installed Vaiz plugin and authorized with OAuth (open the Vaiz connection and complete OAuth sign-in). Reading agents and runs needs the `agents:read` permission of the connection; starting an agent by assigning or mentioning it needs `agents:write` (\"Start AI agents\" on the consent screen).\n\nVaiz tools can appear under different names depending on how Vaiz is connected: `mcp__Vaiz__query_tasks` for a directly configured MCP server, or `mcp__codex_apps__vaiz_query_tasks` (sometimes with a longer app prefix such as `vaiz_testing_`) when Vaiz is installed as an app. Match tool names case-insensitively and by the tool suffix (`query_tasks`, `show_tasks`, …), not by an exact `Vaiz` prefix. Tools may also be loaded lazily: a Vaiz tool that is not in the current tool list is not missing — load it through tool search (for example `Vaiz list_agents`) before concluding it is unavailable. Work with Vaiz only through these tools: do not open app.vaiz.com in a browser or drive the Vaiz desktop app with Computer Use, even if the user's `@Vaiz` mention also resolves to that app.\n\n## Recognising an agent\n\n- Member, task, follower, and comment tools mark agent members with `isAgent: true`. A comment whose author has `isAgent: true` is an agent's reply. History tools add \"(AI agent)\" to the name instead.\n- `list_agents` (optional `projectId`) lists agents with `memberId`, `instructions`, `trigger`, `runsWhen`, `mode`, `writeCapabilities`, `scope`, and `status` / `paused`.\n  - `agentsEnabled: false` — agents are off in the space; assigning one does nothing.\n  - `status: disabled` — the agent cannot run; `statusReason` says why. Do not assign or mention it.\n  - `canStartAgents: false` — the connection lacks `agents:write`; an assignment or mention will not start a run. Tell the user they can reconnect and allow it.\n  - `aiCreditsExhausted: true` — no agent can start until credits refresh or are bought; only the space owner can buy them.\n\n## What starts a run\n\n| Action | Effect |\n| --- | --- |\n| Assign an agent to a task (`create_task` / `edit_task` assignees) | Starts a run on that task |\n| Mention an agent in a task comment (`create_comment` / `edit_comment`) | Starts a run that answers in the thread |\n| Mention in a milestone or document comment, or inside any body | Nothing runs |\n| Add an agent as a follower | Nothing runs |\n\nOnly agents with `answersAssignmentsAndMentions: true` react to assignments and mentions. Agents with event triggers can also react to your edits: creating or changing a task, adding a comment, or creating or editing a milestone in their scope (`runsWhen` says when). Board automations never wake agents.\n\nThe agent's `mode` decides what happens to its changes: `suggest` only proposes, `ask` waits for a human approval on the run page (comments are posted right away), `auto` applies changes immediately. Every run spends the space's AI credits.\n\n## Rules\n\n1. **Confirm first.** Before assigning or mentioning an agent, tell the user it is an AI agent, what it will do (instructions, mode, write capabilities from `list_agents`), and that it will start a run. Proceed only after the user agrees, unless they explicitly asked for that agent.\n2. **No agent as a fallback assignee.** When the user asks to assign \"someone\" or a role, choose among people. Offer an agent only when its instructions fit, and say it is an agent.\n3. **Use the member id** from `list_agents` (the same id as in `query_members`), never `agentId`.\n4. **Report the outcome.** `create_task`, `edit_task`, `create_comment`, and `edit_comment` return `agentInvocations` with `runStarted`, `runUrl`, `mode`, or `notStartedReason`. Say plainly whether the agent started and, if not, why. If an invocation carries `buyCreditsUrl`, give the user that link.\n5. **Do not wait for the agent.** Point the user to the task, its comments, or `runUrl` instead of polling.\n6. **Unassigning stops nothing.** A started run is cancelled only on the run page by a Manager or Owner of the agent's scope.\n\n## Reading what agents did\n\n- `list_agent_runs` — runs newest first, one page at a time (default 20, max 50), filtered by `agentId`, `projectId`, `taskId`, `statuses`, `triggers`, `modes`, or dates. Load the next page with `nextCursor` only when the user needs older runs.\n- `get_agent_run` — one run by `runId` or `number`: the agent's report and every proposed or applied action with its decision (`pending` actions wait for approval on the run page).\n\nReading runs never starts an agent and spends no credits. `create_milestone` and `edit_milestone` do not report the runs they cause; check `list_agent_runs` if the user asks.\n\nFurther reading: https://vaiz.com/help/tutorials/how-to-connect-vaiz-to-mcp · https://vaiz.com\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}