background-process-run-command-sync

Name: background-process-run-command-sync
Author: X-School-Academy

To run a short command and wait for the result, execute a synchronous shell command via the manager and return full output.

by X-School-Academy(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from X-School-Academy/ai-dev-swarm (dev-swarm/mcp-skills/background-process-run-command-sync/SKILL.md). Install upstream with npx skills add X-School-Academy/ai-dev-swarm --skill background-process-run-command-sync. Copyright stays with the author.

Usage

Use the MCP tool dev-swarm.request to send the payload as a JSON string:

{"server_id":"backgroundProcess","tool_name":"run_command_sync","arguments":{}}

Tool Description

Runs a short-lived shell command synchronously and returns full output.

Arguments Schema

The schema below describes the arguments object in the request payload.

{
  "type": "object",
  "properties": {
    "command": {
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Background Tasks

If the tool returns a task id, poll the task status via the MCP request tool:

{"server_id":"backgroundProcess","method":"tasks/status","params":{"task_id":"<task_id>"}}

Installed into a catalogue, chosen by a router

Install background-process-run-command-sync and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

Photo: RDNE Stock project

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot
curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

x-school-academy-ai-dev-swarm-background-process-run-com-a0bb1a.ocm.jsonjson

{
  "ocm": "1",
  "id": "x-school-academy-ai-dev-swarm-background-process-run-com-a0bb1a",
  "kind": "skill",
  "name": "background-process-run-command-sync",
  "description": "To run a short command and wait for the result, execute a synchronous shell command via the manager and return full output.",
  "publisher": "X-School-Academy",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "To run a short command and wait for the result, execute a synchronous shell command via the manager and return full output."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/X-School-Academy/ai-dev-swarm",
      "path": "dev-swarm/mcp-skills/background-process-run-command-sync/SKILL.md",
      "ref": "4248ccf71bc3b6a8f9d694b04fea448aac59db33",
      "url": "https://github.com/X-School-Academy/ai-dev-swarm/blob/4248ccf71bc3b6a8f9d694b04fea448aac59db33/dev-swarm/mcp-skills/background-process-run-command-sync/SKILL.md",
      "key": "X-School-Academy/ai-dev-swarm/dev-swarm/mcp-skills/background-process-run-command-sync/SKILL.md"
    }
  },
  "instructions": "## Usage\nUse the MCP tool `dev-swarm.request` to send the payload as a JSON string:\n\n```json\n{\"server_id\":\"backgroundProcess\",\"tool_name\":\"run_command_sync\",\"arguments\":{}}\n```\n\n## Tool Description\nRuns a short-lived shell command synchronously and returns full output.\n\n## Arguments Schema\nThe schema below describes the `arguments` object in the request payload.\n```json\n{\n  \"type\": \"object\",\n  \"properties\": {\n    \"command\": {\n      \"type\": \"string\"\n    }\n  },\n  \"required\": [\n    \"command\"\n  ],\n  \"additionalProperties\": false,\n  \"$schema\": \"http://json-schema.org/draft-07/schema#\"\n}\n```\n\n## Bac",
  "cost": {
    "context_tokens": 198
  }
}

Fetch it by URL: GET /api/v1/registry/x-school-academy-ai-dev-swarm-background-process-run-com-a0bb1a/manifest?version=1.0.0