crewly 1.0.0

package/config/skills/orchestrator/delegate-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-delegate-task",
+  "name": "Delegate Task",
+  "description": "Send a structured task assignment to an agent with priority and context.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["delegate task", "assign work", "task agent"],
+  "tags": ["task", "delegation", "management"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/get-agent-logs/execute.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Get recent terminal output from an agent's 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\",\"lines\":50}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+LINES=$(echo "$INPUT" | jq -r '.lines // "50"')
+require_param "sessionName" "$SESSION_NAME"
+
+api_call GET "/terminal/${SESSION_NAME}/output?lines=${LINES}"

package/config/skills/orchestrator/get-agent-logs/instructions.md

@@ -0,0 +1,20 @@
+# Get Agent Logs
+
+Retrieves recent terminal output from an agent's PTY session.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/get-agent-logs/execute.sh '{"sessionName":"agent-joe","lines":100}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | The agent's PTY session name |
+| `lines` | No | Number of lines to retrieve (default: 50) |
+
+## Output
+
+JSON with the agent's recent terminal output.

package/config/skills/orchestrator/get-agent-logs/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-get-agent-logs",
+  "name": "Get Agent Logs",
+  "description": "Get recent terminal output from an agent's PTY session.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["agent logs", "check output", "terminal output"],
+  "tags": ["agent", "logs", "monitoring", "terminal"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/get-agent-status/execute.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Get status of a specific agent by session name
+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\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+require_param "sessionName" "$SESSION_NAME"
+
+# Get all teams and filter for the specific agent
+TEAMS=$(api_call GET "/teams")
+echo "$TEAMS" | jq --arg name "$SESSION_NAME" '
+  .data // . | if type == "array" then . else [.] end |
+  [.[].members // [] | .[] | select(.sessionName == $name or .name == $name)] |
+  if length == 0 then {"error": "Agent not found", "sessionName": $name}
+  elif length == 1 then .[0]
+  else .
+  end
+'

package/config/skills/orchestrator/get-agent-status/instructions.md

@@ -0,0 +1,19 @@
+# Get Agent Status
+
+Returns the current status of a specific agent.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/get-agent-status/execute.sh '{"sessionName":"agent-joe"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | The agent's PTY session name |
+
+## Output
+
+JSON object with the agent's status, role, working status, and team membership.

package/config/skills/orchestrator/get-agent-status/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-get-agent-status",
+  "name": "Get Agent Status",
+  "description": "Check the current status of a specific agent by session name.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["agent status", "check agent", "is agent active"],
+  "tags": ["agent", "status", "monitoring"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/get-project-overview/execute.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Get overview of all projects
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+api_call GET "/projects"

package/config/skills/orchestrator/get-project-overview/instructions.md

@@ -0,0 +1,17 @@
+# Get Project Overview
+
+Get an overview of all configured projects.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/get-project-overview/execute.sh
+```
+
+## Parameters
+
+None required.
+
+## Output
+
+JSON array of projects with their details.

package/config/skills/orchestrator/get-project-overview/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-get-project-overview",
+  "name": "Get Project Overview",
+  "description": "Get an overview of all configured projects.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["project overview", "list projects", "show projects"],
+  "tags": ["project", "overview", "management"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/get-tasks/execute.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# Get task progress and overview for the 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 '{\"projectPath\":\"/path/to/project\"}'"
+
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+require_param "projectPath" "$PROJECT_PATH"
+
+# URL-encode the project path
+urlencode() {
+    local length="${#1}"
+    for (( i = 0; i < length; i++ )); do
+        local c="${1:i:1}"
+        case $c in
+            [a-zA-Z0-9.~_-]) printf "$c" ;;
+            *) printf '%%%02X' "'$c" ;;
+        esac
+done
+}
+
+ENCODED_PATH=$(urlencode "$PROJECT_PATH")
+
+api_call GET "/task-management/team-progress?projectPath=${ENCODED_PATH}"

package/config/skills/orchestrator/get-tasks/instructions.md

@@ -0,0 +1,17 @@
+# Get Tasks
+
+Get task progress and overview for the team.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/get-tasks/execute.sh
+```
+
+## Parameters
+
+None required.
+
+## Output
+
+JSON with team task progress including assigned, completed, and blocked tasks.

package/config/skills/orchestrator/get-tasks/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-get-tasks",
+  "name": "Get Tasks",
+  "description": "Get task progress and overview for the team.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["get tasks", "task progress", "show tasks"],
+  "tags": ["task", "progress", "management"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/get-team-status/execute.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Get status of all teams and their agents
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+api_call GET "/teams"

package/config/skills/orchestrator/get-team-status/instructions.md

@@ -0,0 +1,17 @@
+# Get Team Status
+
+Returns the current status of all teams and their member agents.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/get-team-status/execute.sh
+```
+
+## Parameters
+
+None required.
+
+## Output
+
+JSON array of teams with members and their statuses (active/inactive, idle/in_progress).

package/config/skills/orchestrator/get-team-status/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-get-team-status",
+  "name": "Get Team Status",
+  "description": "Get current status of all teams and their agents, including who is active/inactive.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["team status", "list teams", "who is active"],
+  "tags": ["team", "status", "monitoring"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/heartbeat/execute.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# =============================================================================
+# Heartbeat Skill - System health check and heartbeat update
+#
+# Calls multiple API endpoints to:
+# 1. Update the orchestrator heartbeat via the X-Agent-Session middleware
+# 2. Return system status for situational awareness
+# =============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../../_common/lib.sh"
+
+# Collect status from multiple endpoints (each call updates heartbeat via middleware)
+teams_response=$(api_call GET "/teams" 2>/dev/null) || teams_response='{"error":"unavailable"}'
+projects_response=$(api_call GET "/projects" 2>/dev/null) || projects_response='{"error":"unavailable"}'
+queue_response=$(api_call GET "/messaging/queue/status" 2>/dev/null) || queue_response='{"error":"unavailable"}'
+
+# Count teams and projects
+team_count=$(echo "$teams_response" | python3 -c "import sys,json; d=json.load(sys.stdin); print(len(d.get('teams',d)) if isinstance(d,dict) else len(d))" 2>/dev/null || echo "?")
+project_count=$(echo "$projects_response" | python3 -c "import sys,json; d=json.load(sys.stdin); print(len(d.get('projects',d)) if isinstance(d,dict) else len(d))" 2>/dev/null || echo "?")
+
+# Extract queue status
+queue_pending=$(echo "$queue_response" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('pendingCount',d.get('pending','?')))" 2>/dev/null || echo "?")
+queue_processing=$(echo "$queue_response" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('processingCount',d.get('processing','?')))" 2>/dev/null || echo "?")
+
+cat <<EOF
+{
+  "status": "ok",
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "summary": {
+    "teams": $team_count,
+    "projects": $project_count,
+    "queuePending": $queue_pending,
+    "queueProcessing": $queue_processing
+  }
+}
+EOF

package/config/skills/orchestrator/heartbeat/instructions.md

@@ -0,0 +1,24 @@
+# Heartbeat Skill
+
+Perform a system health check and heartbeat update.
+
+## When to Use
+
+Run this skill periodically (every 10-15 minutes) to:
+- Keep the orchestrator heartbeat alive so the system knows you are responsive
+- Get a quick overview of system status (teams, projects, message queue)
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/heartbeat/execute.sh
+```
+
+No parameters required.
+
+## Output
+
+Returns a JSON object with:
+- `status`: "ok" if all endpoints responded
+- `timestamp`: UTC timestamp of the check
+- `summary`: team count, project count, queue pending/processing counts

package/config/skills/orchestrator/heartbeat/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-heartbeat",
+  "name": "Heartbeat",
+  "description": "Perform a system health check and heartbeat. Calls multiple API endpoints to update heartbeat via middleware and returns system status.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["heartbeat", "health check", "system status"],
+  "tags": ["monitoring", "heartbeat", "health"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/list-subscriptions/execute.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# List active event subscriptions
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+api_call GET "/events/subscriptions"

package/config/skills/orchestrator/list-subscriptions/instructions.md

@@ -0,0 +1,17 @@
+# List Subscriptions
+
+Lists all active event subscriptions.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/list-subscriptions/execute.sh
+```
+
+## Parameters
+
+None required.
+
+## Output
+
+JSON array of active subscriptions with their IDs, event types, and filters.

package/config/skills/orchestrator/list-subscriptions/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-list-subscriptions",
+  "name": "List Subscriptions",
+  "description": "List your active event subscriptions.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["list subscriptions", "show subscriptions", "active subscriptions"],
+  "tags": ["events", "monitoring", "subscription"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/query-knowledge/execute.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Query Knowledge Documents - search company knowledge base
+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 '{\"query\":\"deployment\",\"scope\":\"global\"}'"
+
+QUERY=$(echo "$INPUT" | jq -r '.query // empty')
+SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
+CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+require_param "query" "$QUERY"
+
+# URL-encode the query parameters
+ENCODED_QUERY=$(printf '%s' "$QUERY" | jq -sRr @uri)
+ENDPOINT="/knowledge/documents?scope=${SCOPE}&search=${ENCODED_QUERY}"
+
+if [ -n "$CATEGORY" ]; then
+  ENCODED_CATEGORY=$(printf '%s' "$CATEGORY" | jq -sRr @uri)
+  ENDPOINT="${ENDPOINT}&category=${ENCODED_CATEGORY}"
+fi
+
+if [ -n "$PROJECT_PATH" ]; then
+  ENCODED_PATH=$(printf '%s' "$PROJECT_PATH" | jq -sRr @uri)
+  ENDPOINT="${ENDPOINT}&projectPath=${ENCODED_PATH}"
+fi
+
+api_call GET "$ENDPOINT"

package/config/skills/orchestrator/query-knowledge/instructions.md

@@ -0,0 +1,47 @@
+# Query Knowledge
+
+Search the company knowledge base for relevant documents. Use this to find SOPs, runbooks, architecture docs, team norms, and other documentation before delegating process-oriented tasks.
+
+Knowledge documents are stored at two scopes:
+- **global** (`~/.crewly/docs/`) — company-wide documents accessible to all agents
+- **project** (`{projectPath}/.crewly/docs/`) — project-specific documents
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `query` | Yes | Search text to match against document titles, tags, and content |
+| `scope` | No | `global` (default) or `project` |
+| `category` | No | Filter by category: `SOPs`, `Team Norms`, `Architecture`, `Onboarding`, `Runbooks`, `General` |
+| `projectPath` | Conditional | Required when scope is `project` |
+
+## Examples
+
+### Search global knowledge for deployment docs
+
+```bash
+bash config/skills/orchestrator/query-knowledge/execute.sh '{"query":"deployment","scope":"global"}'
+```
+
+### Search project-specific architecture docs
+
+```bash
+bash config/skills/orchestrator/query-knowledge/execute.sh '{"query":"API design","scope":"project","projectPath":"/path/to/project","category":"Architecture"}'
+```
+
+### Search for runbooks before delegating
+
+```bash
+bash config/skills/orchestrator/query-knowledge/execute.sh '{"query":"incident response","scope":"global","category":"Runbooks"}'
+```
+
+## When to Use
+
+- **Before delegating process-oriented tasks** — check for SOPs/runbooks to include in task context
+- **Before architecture decisions** — search for existing architecture docs
+- **When onboarding agents to a project** — find onboarding guides and team norms
+- **Before answering user questions** about processes, conventions, or infrastructure
+
+## Output
+
+JSON response with `success: true` and a `data` array of matching document summaries (id, title, category, tags, preview).

package/config/skills/orchestrator/query-knowledge/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-query-knowledge",
+  "name": "Query Knowledge",
+  "description": "Search the company knowledge base for SOPs, runbooks, architecture docs, and other documentation.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["query knowledge", "search knowledge", "find docs", "search docs", "find runbook", "find SOP"],
+  "tags": ["memory", "knowledge", "search", "documentation"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/recall/execute.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Retrieve relevant knowledge from agent memory
+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 '{\"context\":\"deployment process\",\"scope\":\"both\",\"teamMemberId\":\"...\"}'"
+
+CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
+require_param "context" "$CONTEXT"
+
+api_call POST "/memory/recall" "$INPUT"

package/config/skills/orchestrator/recall/instructions.md

@@ -0,0 +1,23 @@
+# Recall
+
+Retrieve relevant knowledge from your persistent memory.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/recall/execute.sh '{"context":"deployment process","scope":"both","teamMemberId":"crewly-orc"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `context` | Yes | What you're looking for or working on |
+| `scope` | No | Scope: `agent`, `project`, or `both` (default: `both`) |
+| `limit` | No | Maximum number of results |
+| `teamMemberId` | No | Your session name |
+| `projectPath` | No | Current project path |
+
+## Output
+
+JSON array of relevant knowledge entries sorted by relevance.

package/config/skills/orchestrator/recall/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-recall",
+  "name": "Recall",
+  "description": "Retrieve relevant knowledge from memory based on context.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["recall", "remember what", "check memory"],
+  "tags": ["memory", "knowledge", "retrieval"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/record-failure/execute.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Record a failed approach or pitfall to avoid
+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 '{\"description\":\"...\",\"projectPath\":\"...\",\"teamMemberId\":\"...\",\"context\":\"...\"}'"
+
+DESCRIPTION=$(echo "$INPUT" | jq -r '.description // empty')
+require_param "description" "$DESCRIPTION"
+
+api_call POST "/memory/record-failure" "$INPUT"

package/config/skills/orchestrator/record-failure/instructions.md

@@ -0,0 +1,22 @@
+# Record Failure
+
+Record a failed approach or pitfall so the team can avoid repeating it.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/record-failure/execute.sh '{"description":"Deploying database migrations during peak hours caused 5min downtime","projectPath":"/path/to/project","teamMemberId":"crewly-orc","context":"production deploy on 2026-02-10"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `description` | Yes | What failed and why it did not work |
+| `projectPath` | No | Path to the project where this failed |
+| `teamMemberId` | No | Your session name |
+| `context` | No | Additional context about when/where this failed |
+
+## Output
+
+JSON confirmation with the stored failure entry.