android-plugin

Manage and execute app-specific plugins — install, configure, run actions, check status, approval workflows

When to use

Use this skill when automating a specific app that has a dedicated plugin (e.g., messaging apps, social apps). Plugins wrap app-specific logic behind a standard interface with approval gates for sensitive actions.

Tools

ToolPurpose
android_plugin_actionExecute a plugin action (e.g., weather.fetch, telegram.send)
android_plugin_statusGet status of all loaded plugins (ready/offline, rate limits)
android_plugin_cycleRun a plugin's autonomous heartbeat cycle
android_skillsDiscover all plugin capabilities and their parameters

Plugin action workflow

  1. Discover capabilities: android_skills { format: "markdown" }
  2. Check plugin health: android_plugin_status
  3. Execute action: android_plugin_action { plugin: "name", action: "capability", params: {...} }
  4. If approval required: the system will prompt for confirmation before executing

Approval gates

Actions marked requiresApproval: true trigger a confirmation flow before execution. This applies to actions that:

  • Send messages to other people
  • Make purchases or financial transactions
  • Take irreversible actions (delete, block, unmatch)
  • Post content visible to others

Read-only actions (status checks, profile viewing) execute immediately.

Plugin lifecycle

plugin.initialize(config)    → Setup and auth
plugin.getStatus()           → Health check (ready/offline/rate-limited)
plugin.execute(action, params) → Run an action
plugin.onHeartbeat()         → Autonomous cycle (check for new activity)
plugin.destroy()             → Graceful shutdown

Example

"What plugins are available?" → android_skills { format: "markdown" }
"Check if Telegram is connected" → android_plugin_status
"Run the weather cycle" → android_plugin_cycle { plugin: "weather" }
"Send a message via plugin" → android_plugin_action { plugin: "telegram", action: "telegram.send", params: { text: "Hello" } }