crewly 1.0.0

package/config/skills/orchestrator/schedule-check/execute.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Schedule a future check-in reminder
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"minutes\":5,\"message\":\"Check on agent-joe progress\",\"recurring\":true}'"
+
+MINUTES=$(echo "$INPUT" | jq -r '.minutes // empty')
+MESSAGE=$(echo "$INPUT" | jq -r '.message // empty')
+TARGET=$(echo "$INPUT" | jq -r '.target // empty')
+RECURRING=$(echo "$INPUT" | jq -r '.recurring // false')
+MAX_OCCURRENCES=$(echo "$INPUT" | jq -r '.maxOccurrences // empty')
+require_param "minutes" "$MINUTES"
+require_param "message" "$MESSAGE"
+
+# Default target to the caller's own session (orchestrator sends reminders to itself)
+TARGET_SESSION="${TARGET:-${TMUX_SESSION_NAME:-crewly-orc}}"
+
+# API expects: targetSession, minutes, message
+# When recurring, also send isRecurring, intervalMinutes, and optional maxOccurrences
+if [ "$RECURRING" = "true" ]; then
+  BODY=$(jq -n --arg target "$TARGET_SESSION" --arg minutes "$MINUTES" --arg message "$MESSAGE" \
+    '{targetSession: $target, minutes: ($minutes | tonumber), intervalMinutes: ($minutes | tonumber), message: $message, isRecurring: true}')
+  # Add maxOccurrences if provided
+  if [ -n "$MAX_OCCURRENCES" ]; then
+    BODY=$(echo "$BODY" | jq --arg max "$MAX_OCCURRENCES" '. + {maxOccurrences: ($max | tonumber)}')
+  fi
+else
+  BODY=$(jq -n --arg target "$TARGET_SESSION" --arg minutes "$MINUTES" --arg message "$MESSAGE" \
+    '{targetSession: $target, minutes: ($minutes | tonumber), message: $message}')
+fi
+
+api_call POST "/schedule" "$BODY"

package/config/skills/orchestrator/schedule-check/instructions.md

@@ -0,0 +1,35 @@
+# Schedule Check
+
+Schedule a future check-in reminder that will be delivered to your terminal.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/schedule-check/execute.sh '{"minutes":5,"message":"Check on agent-joe progress"}'
+```
+
+### Recurring check
+
+```bash
+bash config/skills/orchestrator/schedule-check/execute.sh '{"minutes":10,"message":"Status report","recurring":true}'
+```
+
+### Recurring check with max occurrences
+
+```bash
+bash config/skills/orchestrator/schedule-check/execute.sh '{"minutes":10,"message":"Status report","recurring":true,"maxOccurrences":6}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `minutes` | Yes | Delay in minutes before the check fires |
+| `message` | Yes | Reminder message text |
+| `target` | No | Target session name (defaults to self) |
+| `recurring` | No | When `true`, the check repeats every `minutes` interval (default: `false`) |
+| `maxOccurrences` | No | Maximum number of times a recurring check fires (default: unlimited). Only used when `recurring` is `true`. |
+
+## Output
+
+JSON with the scheduled check ID and fire time.

package/config/skills/orchestrator/schedule-check/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-schedule-check",
+  "name": "Schedule Check",
+  "description": "Schedule a future check-in or reminder.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["schedule check", "remind me", "check in later"],
+  "tags": ["scheduling", "monitoring", "reminder"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/send-key/execute.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Send a key to an agent's terminal session
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-""}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"sessionName\":\"agent-session\",\"key\":\"Enter\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+KEY=$(echo "$INPUT" | jq -r '.key // empty')
+require_param "sessionName" "$SESSION_NAME"
+require_param "key" "$KEY"
+
+BODY=$(jq -n --arg key "$KEY" '{key: $key}')
+
+api_call POST "/terminal/${SESSION_NAME}/key" "$BODY"

package/config/skills/orchestrator/send-message/execute.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Send a message to an agent's terminal session
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"sessionName\":\"agent-session\",\"message\":\"hello\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+MESSAGE=$(echo "$INPUT" | jq -r '.message // empty')
+require_param "sessionName" "$SESSION_NAME"
+require_param "message" "$MESSAGE"
+
+BODY=$(jq -n --arg message "$MESSAGE" '{message: $message}')
+
+api_call POST "/terminal/${SESSION_NAME}/deliver" "$BODY"

package/config/skills/orchestrator/send-message/instructions.md

@@ -0,0 +1,20 @@
+# Send Message
+
+Sends a text message to an agent's terminal session.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/send-message/execute.sh '{"sessionName":"agent-joe","message":"Please review the PR"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | The target agent's PTY session name |
+| `message` | Yes | The message text to send |
+
+## Output
+
+JSON confirmation of delivery.

package/config/skills/orchestrator/send-message/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-send-message",
+  "name": "Send Message",
+  "description": "Send a text message to an agent's terminal session.",
+  "category": "communication",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["send message", "tell agent", "message agent"],
+  "tags": ["communication", "agent", "message"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/send-pdf-to-slack/execute.sh

@@ -0,0 +1,182 @@
+#!/bin/bash
+# Convert a markdown file to PDF using weasyprint and upload it to a Slack channel
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+print_usage() {
+  cat <<'EOF_USAGE'
+Usage:
+  bash execute.sh --channel C0123 --file /path/to/doc.md --title "Report"
+
+Options:
+  --channel | -c   Slack channel ID (required)
+  --file    | -f   Path to the markdown file to convert (required)
+  --title   | -T   Title for the uploaded PDF (optional)
+  --text    | -t   Initial comment to include with the upload (optional)
+  --thread  | -r   Slack thread timestamp for threaded upload (optional)
+  --help    | -h   Show this help
+EOF_USAGE
+}
+
+CHANNEL_ID=""
+MD_FILE=""
+TITLE=""
+TEXT=""
+THREAD_TS=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --channel|-c)
+      CHANNEL_ID="$2"
+      shift 2
+      ;;
+    --file|-f)
+      MD_FILE="$2"
+      shift 2
+      ;;
+    --title|-T)
+      TITLE="$2"
+      shift 2
+      ;;
+    --text|-t)
+      TEXT="$2"
+      shift 2
+      ;;
+    --thread|-r)
+      THREAD_TS="$2"
+      shift 2
+      ;;
+    --help|-h)
+      print_usage
+      exit 0
+      ;;
+    *)
+      error_exit "Unknown argument: $1"
+      ;;
+  esac
+done
+
+require_param "channel" "$CHANNEL_ID"
+require_param "file" "$MD_FILE"
+
+# Validate markdown file exists
+if [ ! -f "$MD_FILE" ]; then
+  error_exit "Markdown file not found: $MD_FILE"
+fi
+
+# Check required dependencies
+if ! command -v python3 &>/dev/null; then
+  error_exit "python3 is not installed. Install it with: brew install python3 (macOS) or sudo apt-get install python3 (Linux)."
+fi
+if ! command -v jq &>/dev/null; then
+  error_exit "jq is not installed. Install it with: brew install jq (macOS) or sudo apt-get install jq (Linux)."
+fi
+
+# Set up a persistent venv with weasyprint + markdown if not already present
+CREWLY_HOME="${HOME}/.crewly"
+VENV_DIR="${CREWLY_HOME}/venv/pdf-tools"
+PYTHON="${VENV_DIR}/bin/python3"
+
+if [ ! -f "$PYTHON" ]; then
+  echo '{"status":"installing","message":"Setting up PDF tools (first-time only)..."}' >&2
+  python3 -m venv "$VENV_DIR"
+  "${VENV_DIR}/bin/pip" install --quiet weasyprint markdown 2>&1 >&2
+fi
+
+# Verify weasyprint is importable
+if ! "$PYTHON" -c "import weasyprint, markdown" 2>/dev/null; then
+  echo '{"status":"installing","message":"Reinstalling PDF tools..."}' >&2
+  "${VENV_DIR}/bin/pip" install --quiet --force-reinstall weasyprint markdown 2>&1 >&2
+fi
+
+# Prepare temp directory and output path
+TMP_DIR="${CREWLY_HOME}/tmp/slack-pdfs"
+mkdir -p "$TMP_DIR"
+
+# Generate a unique output filename based on input name + timestamp
+BASE_NAME="$(basename "$MD_FILE" .md)"
+TIMESTAMP="$(date +%s)"
+PDF_FILE="${TMP_DIR}/${BASE_NAME}-${TIMESTAMP}.pdf"
+
+# Ensure temp PDF is cleaned up on exit (success or failure)
+cleanup() { rm -f "$PDF_FILE" "/tmp/weasyprint-err-$$.log"; }
+trap cleanup EXIT
+
+# Convert markdown to PDF using weasyprint
+if ! "$PYTHON" -c "
+import sys, markdown, weasyprint
+
+md_file = sys.argv[1]
+pdf_file = sys.argv[2]
+
+with open(md_file, 'r', encoding='utf-8') as f:
+    md_content = f.read()
+
+html = markdown.markdown(md_content, extensions=['tables', 'fenced_code', 'codehilite', 'toc', 'meta'])
+
+styled_html = '''<!DOCTYPE html>
+<html><head><meta charset=\"utf-8\">
+<style>
+  body { font-family: -apple-system, \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;
+         max-width: 800px; margin: 40px auto; padding: 0 20px; line-height: 1.8;
+         font-size: 14px; color: #333; }
+  h1 { font-size: 24px; border-bottom: 2px solid #333; padding-bottom: 8px; }
+  h2 { font-size: 20px; border-bottom: 1px solid #ddd; padding-bottom: 6px; margin-top: 28px; }
+  h3 { font-size: 16px; margin-top: 20px; }
+  table { border-collapse: collapse; width: 100%; margin: 16px 0; }
+  th, td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; }
+  th { background-color: #f5f5f5; font-weight: 600; }
+  code { background: #f4f4f4; padding: 2px 6px; border-radius: 3px; font-size: 13px; }
+  pre { background: #f4f4f4; padding: 16px; border-radius: 6px; overflow-x: auto; }
+  blockquote { border-left: 4px solid #ddd; margin: 16px 0; padding: 8px 16px; color: #666; }
+  ul, ol { padding-left: 24px; }
+  li { margin: 4px 0; }
+</style></head><body>''' + html + '</body></html>'
+
+weasyprint.HTML(string=styled_html).write_pdf(pdf_file)
+" "$MD_FILE" "$PDF_FILE" 2>/tmp/weasyprint-err-$$.log; then
+  WP_ERR="$(cat /tmp/weasyprint-err-$$.log 2>/dev/null || echo 'unknown error')"
+  error_exit "weasyprint conversion failed: ${WP_ERR}"
+fi
+
+# Verify PDF was created
+if [ ! -f "$PDF_FILE" ]; then
+  error_exit "PDF file was not created at: $PDF_FILE"
+fi
+
+# Build upload request body
+UPLOAD_TITLE="${TITLE:-${BASE_NAME}.pdf}"
+BODY=$(jq -n \
+  --arg channelId "$CHANNEL_ID" \
+  --arg filePath "$PDF_FILE" \
+  --arg filename "${BASE_NAME}.pdf" \
+  --arg title "$UPLOAD_TITLE" \
+  --arg initialComment "${TEXT:-}" \
+  --arg threadTs "${THREAD_TS:-}" \
+  '{channelId: $channelId, filePath: $filePath, filename: $filename, title: $title} +
+   (if $initialComment != "" then {initialComment: $initialComment} else {} end) +
+   (if $threadTs != "" then {threadTs: $threadTs} else {} end)')
+
+# Upload to Slack
+RESULT=$(api_call POST "/slack/upload-file" "$BODY")
+
+# Output the result
+echo "$RESULT"
+
+# Emit a [NOTIFY] block so the chat service captures this action
+{
+  echo "[NOTIFY]"
+  echo "type: slack_pdf_upload"
+  echo "title: PDF Uploaded to Slack"
+  echo "channelId: $CHANNEL_ID"
+  if [ -n "$THREAD_TS" ]; then
+    echo "threadTs: $THREAD_TS"
+  fi
+  echo "---"
+  printf 'Converted %s to PDF and uploaded to Slack channel %s\n' "$MD_FILE" "$CHANNEL_ID"
+  if [ -n "$TEXT" ]; then
+    printf 'Comment: %s\n' "$TEXT"
+  fi
+  echo "[/NOTIFY]"
+} >&2

package/config/skills/orchestrator/send-pdf-to-slack/instructions.md

@@ -0,0 +1,49 @@
+# Send PDF to Slack
+
+Converts a markdown file to PDF using `weasyprint` (Python) and uploads it to a Slack channel via the `/api/slack/upload-file` endpoint.
+
+## Prerequisites
+
+- **python3** must be installed (comes with macOS, or `brew install python3`)
+- On first run, a virtual environment is created at `~/.crewly/venv/pdf-tools/` with `weasyprint` and `markdown` packages installed automatically
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/send-pdf-to-slack/execute.sh --channel C0123ABC --file /path/to/document.md --title "Weekly Report"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--channel`, `-c` | Yes | Slack channel ID to upload the PDF to |
+| `--file`, `-f` | Yes | Path to the markdown file to convert |
+| `--title`, `-T` | No | Title for the uploaded PDF (defaults to filename) |
+| `--text`, `-t` | No | Initial comment to include with the upload |
+| `--thread`, `-r` | No | Slack thread timestamp for threaded upload |
+
+## Examples
+
+```bash
+# Basic upload
+bash execute.sh --channel C0123ABC --file report.md
+
+# Upload with title and comment
+bash execute.sh --channel C0123ABC --file report.md --title "Q4 Report" --text "Here is the quarterly report"
+
+# Upload in a thread
+bash execute.sh --channel C0123ABC --file notes.md --thread 1707123456.789000
+```
+
+## Output
+
+JSON response from the upload API with `fileId` on success. Also emits a `[NOTIFY]` block for chat service integration.
+
+## Error Handling
+
+- Exits with error if `python3` is not installed (includes install instructions)
+- Auto-installs weasyprint/markdown into a persistent venv on first run
+- Exits with error if the markdown file does not exist
+- Exits with error if PDF conversion fails
+- Temp PDF files are cleaned up after upload (stored in `~/.crewly/tmp/slack-pdfs/`)

package/config/skills/orchestrator/send-pdf-to-slack/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-send-pdf-to-slack",
+  "name": "Send PDF to Slack",
+  "description": "Convert a markdown file to PDF and upload it to a Slack channel.",
+  "category": "communication",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 60000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["send pdf", "pdf to slack", "markdown to pdf", "export pdf"],
+  "tags": ["communication", "slack", "pdf", "markdown", "export"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/set-goal/execute.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Set a project goal
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"goal\":\"...\",\"projectPath\":\"...\",\"setBy\":\"orchestrator\"}'"
+
+GOAL=$(echo "$INPUT" | jq -r '.goal // empty')
+require_param "goal" "$GOAL"
+
+api_call POST "/memory/goals" "$INPUT"

package/config/skills/orchestrator/set-goal/instructions.md

@@ -0,0 +1,21 @@
+# Set Goal
+
+Set a project-level goal to guide team priorities and track progress.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/set-goal/execute.sh '{"goal":"Complete API integration by end of sprint","projectPath":"/path/to/project","setBy":"orchestrator"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `goal` | Yes | The goal description |
+| `projectPath` | No | Path to the project this goal applies to |
+| `setBy` | No | Who is setting the goal (e.g., "orchestrator") |
+
+## Output
+
+JSON confirmation with the stored goal entry.

package/config/skills/orchestrator/set-goal/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-set-goal",
+  "name": "Set Goal",
+  "description": "Set a project-level goal to guide team priorities and track progress.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["set goal", "add goal", "new goal", "project goal"],
+  "tags": ["memory", "goals", "planning", "project"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/start-agent/execute.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Start a specific agent within a team
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"teamId\":\"team-uuid\",\"memberId\":\"member-uuid\"}'"
+
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // empty')
+MEMBER_ID=$(echo "$INPUT" | jq -r '.memberId // empty')
+require_param "teamId" "$TEAM_ID"
+require_param "memberId" "$MEMBER_ID"
+
+api_call POST "/teams/${TEAM_ID}/members/${MEMBER_ID}/start"

package/config/skills/orchestrator/start-agent/instructions.md

@@ -0,0 +1,20 @@
+# Start Agent
+
+Starts a specific agent within a team.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/start-agent/execute.sh '{"teamId":"team-uuid","memberId":"member-uuid"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `teamId` | Yes | The team's UUID |
+| `memberId` | Yes | The member's UUID within the team |
+
+## Output
+
+JSON confirmation with agent startup status.

package/config/skills/orchestrator/start-agent/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-start-agent",
+  "name": "Start Agent",
+  "description": "Start a specific agent within a team.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 60000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["start agent", "activate agent", "boot agent"],
+  "tags": ["agent", "management", "lifecycle"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/start-team/execute.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Start all agents in a team
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"teamId\":\"team-uuid\",\"projectId\":\"project-uuid\"}'"
+
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // empty')
+require_param "teamId" "$TEAM_ID"
+
+# Pass the full input as the request body (backend accepts optional projectId)
+api_call POST "/teams/${TEAM_ID}/start" "$INPUT"

package/config/skills/orchestrator/start-team/instructions.md

@@ -0,0 +1,20 @@
+# Start Team
+
+Starts all agents in a team.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/start-team/execute.sh '{"teamId":"abc-123-uuid"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `teamId` | Yes | The team's UUID |
+| `projectId` | No | Project UUID to assign before starting (uses team's current project if omitted) |
+
+## Output
+
+JSON confirmation with team startup status.

package/config/skills/orchestrator/start-team/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-start-team",
+  "name": "Start Team",
+  "description": "Start all agents in a team.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 60000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["start team", "activate team", "boot team"],
+  "tags": ["team", "management", "lifecycle"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/stop-agent/execute.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Stop a specific agent within a team
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"teamId\":\"team-uuid\",\"memberId\":\"member-uuid\"}'"
+
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // empty')
+MEMBER_ID=$(echo "$INPUT" | jq -r '.memberId // empty')
+require_param "teamId" "$TEAM_ID"
+require_param "memberId" "$MEMBER_ID"
+
+api_call POST "/teams/${TEAM_ID}/members/${MEMBER_ID}/stop"

package/config/skills/orchestrator/stop-agent/instructions.md

@@ -0,0 +1,20 @@
+# Stop Agent
+
+Stops a specific agent within a team.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/stop-agent/execute.sh '{"teamId":"team-uuid","memberId":"member-uuid"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `teamId` | Yes | The team's UUID |
+| `memberId` | Yes | The member's UUID within the team |
+
+## Output
+
+JSON confirmation with agent shutdown status.

package/config/skills/orchestrator/stop-agent/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-stop-agent",
+  "name": "Stop Agent",
+  "description": "Stop a specific agent within a team.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["stop agent", "deactivate agent", "shutdown agent"],
+  "tags": ["agent", "management", "lifecycle"],
+  "version": "1.0.0"
+}