OpenParable
Skip to content
← Back to skills

Command Dispatch

Apps & Automation
command-dispatch

Command Dispatch is an Agent Skill for apps & automation published in the jxxghp/MoviePilot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use this skill when the user's intent is to execute a system or plugin function. Applicable scenarios include: 1) The user sends a slash command starting with / (e.g. /cookiecloud, /sites, /subscribes, etc.); 2) The user describes an action in natural language that can be fulfilled by a system or plugin command (e.g. "sync sites", "show subscriptions", "refresh subscriptions", "check downloads", etc.). This skill helps you identify the user's intent, find the matching command, extract necessary parameters, and execute the corresponding command.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/jxxghp/MoviePilot/blob/HEAD/skills/command-dispatch/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/command-dispatch, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Command Dispatch

Use this skill to identify user intent and dispatch the corresponding system or plugin command.

When to Use

  • The user sends a /xxx slash command (execute directly)
  • The user describes an action in natural language, for example:
    • "Sync sites" → /cookiecloud
    • "Show my subscriptions" → /subscribes
    • "Refresh subscriptions" → /subscribes refresh
    • "What's downloading?" → /downloading
    • "Organize downloaded files" → /transfer
    • "Clear cache" → /clear_cache
    • "Restart the system" → /restart
    • "Pause all QB tasks" → /pause_torrents (plugin command)

Tools

  • list_slash_commands — List all available slash commands (system + plugin), returns command name, description, and category
  • query_plugin_capabilities — Query detailed plugin capabilities (commands, actions, scheduled services)
  • run_slash_command — Execute a specified command (works for both system and plugin commands)

Workflow

Step 1: Identify User Intent

Determine whether the user's message is requesting the execution of a command:

  • Direct command: Message starts with /, e.g. /sites, /subscribes → skip to Step 3
  • Natural language: The user describes an actionable request → continue to Step 2

Step 2: Find Matching Command

Use list_slash_commands to retrieve all available commands. Match the user's described intent against the description and category fields of each command.

If the user's description involves a specific plugin's functionality, additionally use query_plugin_capabilities to query that plugin's detailed capabilities.

Matching strategy:

  • Prefer exact matches on command description
  • Then narrow down by category and match
  • If no matching command is found, inform the user that no corresponding function is available

Step 3: Extract Parameters and Execute

Some commands support additional arguments (space-separated after the command), for example:

  • /redo <history_id> — Manually re-organize a specific record
  • /sites disable <site_id> — Disable one or more sites
  • /subscribes delete <subscribe_id> — Delete one or more subscriptions

Use run_slash_command to execute the command in the format /command_name arg1 arg2.

Step 4: Report Result

Command execution is asynchronous. After triggering, inform the user that the command has started. If the command does not exist, list available commands for reference.

Important Notes

  • Command execution requires admin privileges; the tool will automatically check permissions
  • Both system and plugin commands are executed via the run_slash_command tool — no need to distinguish between them
  • If you are unsure which command matches the user's intent, use list_slash_commands first to look up before deciding
  • Never guess non-existent commands; always select from the available command list