Skip to content

Tricentis/mcp-skills / Tosca/Cloud/CLI/claude/skills/tosca-agents

tosca-agents

Verified

List, view, shut down, or delete execution agents in Tosca Cloud

FileKindSize
SKILL.mdskill md2.5 KB
---
name: tosca-agents
description: List, view, shut down, or delete execution agents in Tosca Cloud
user-invocable: true
allowed-tools: Bash(toscactl *)
argument-hint: "[list|view|shutdown|delete|screenshot] [options]"
---

# Manage Execution Agents

Manage Elastic Execution Grid (E2G) agents, both self-hosted and Tricentis-hosted.

Always use `--json --silent` on every `toscactl` command.

## Routing

Parse `$ARGUMENTS` to determine the intent:

- **List agents** (default if no subcommand or user says "list", "show", "agents"):
  ```
  toscactl agents list --json --silent [--state connected|disconnected] [--agent-state idle|executing] [--hosted] [--self-hosted] [--characteristic KEY=VALUE] [--page-size 50]
  ```

- **View agent details** — if the user provides an agent ID:
  ```
  toscactl agents view <id> --json --silent
  ```

- **Shut down an agent** — if the user says "shutdown", "stop", or "shut down":
  ```
  toscactl agents shutdown <id> --json --silent [--on-idle]
  ```
  `--on-idle` is only valid for self-hosted agents. Confirm with the user before proceeding.

- **Delete an agent** — if the user says "delete" or "remove":
  ```
  toscactl agents delete <id> --dangerously-skip-confirmation --json --silent
  ```
  Only works for self-hosted agents. Warn the user this is irreversible and ask for explicit confirmation before proceeding.

- **Screenshot** — if the user says "screenshot", "live view", or "liveview":
  ```
  toscactl agents screenshot <id> --json --silent
  ```
  Returns the last screenshot URL and capture timestamp.

## Presentation

- **List:** Show agent count. For each agent, display: ID, connection state, agent state, type (hosted/self-hosted), last update, and authorized by.
- **View:** Show all agent details including characteristics.
- **Shutdown/Delete:** Confirm the action was initiated.
- **Screenshot:** Show the screenshot URL and capture timestamp. Offer to open it.

## Filtering Tips

- `--state connected` — show only connected agents
- `--agent-state idle` — show only idle agents ready for execution
- `--hosted` / `--self-hosted` — filter by agent type
- `--characteristic os=Windows` — filter by characteristic (repeatable)

## Error Handling

- If the agent is not found, suggest listing agents first.
- If delete is attempted on a hosted agent, explain it's only available for self-hosted agents.
- If commands fail with auth errors, check auth with `toscactl config --json --silent` and suggest re-authenticating with `/tosca-setup`.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall