background-process-stop-process
To stop a managed background task, terminate a running process by ID to shut it down cleanly.
When & Why to Use This Skill
The background-process-stop-process skill is a vital utility for managing system resources and execution lifecycles. It allows Claude to programmatically terminate specific background tasks using a unique process ID (UUID), ensuring a clean and controlled shutdown of running operations. This skill is essential for maintaining environment stability, preventing resource leaks, and managing long-running asynchronous tasks in automated workflows.
Use Cases
- Resource Management: Terminating long-running background scripts or local development servers that are no longer needed to free up CPU and memory.
- Error Recovery: Force-closing hung or non-responsive processes identified during automated testing or debugging sessions to restore system state.
- Workflow Orchestration: Shutting down specific task components in a multi-stage automation pipeline before transitioning to subsequent phases.
- Process Cleanup: Ensuring that temporary background workers or sidecar processes are properly decommissioned after completing their assigned functions.
| name | background-process-stop-process |
|---|---|
| description | "To stop a managed background task, terminate a running process by ID to shut it down cleanly." |
Usage
Use the MCP tool dev-swarm.request to send the payload as a JSON string:
{"server_id":"backgroundProcess","tool_name":"stop_process","arguments":{}}
Tool Description
Stops a running background process.
Arguments Schema
The schema below describes the arguments object in the request payload.
{
"type": "object",
"properties": {
"processId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"processId"
],
"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>"}}