crewly 1.0.8 → 1.0.10

package/config/skills/agent/core/read-task/instructions.md

@@ -0,0 +1,19 @@
+# Read Task
+
+Read the full details of a task file by its absolute path. Returns the task content, metadata, status, and any subtasks.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+
+## Example
+
+```bash
+bash config/skills/agent/read-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md"}'
+```
+
+## Output
+
+JSON with full task details including description, acceptance criteria, priority, status, and related files.

package/config/skills/agent/core/read-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-read-task",
+  "name": "Read Task",
+  "description": "Read the full details of a task file by its absolute path.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["read task", "view task", "show task", "task details"],
+  "tags": ["task", "read", "details"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/recall/execute.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Retrieve stored memories relevant to a given context
+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 '{\"agentId\":\"dev-1\",\"context\":\"authentication patterns\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "context" "$CONTEXT"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  context: .context
+} +
+  (if .scope then {scope: .scope} else {} end) +
+  (if .limit then {limit: (.limit | tonumber)} else {} end) +
+  (if .projectPath then {projectPath: .projectPath} else {} end)')
+
+api_call POST "/memory/recall" "$BODY"

package/config/skills/agent/core/recall/instructions.md

@@ -0,0 +1,23 @@
+# Recall
+
+Retrieve stored memories relevant to a given context or query. Use this to look up past decisions, architectural patterns, or findings before starting related work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `context` | Yes | Search context or query describing what you want to recall |
+| `scope` | No | Filter by scope: `"project"`, `"team"`, or `"global"` |
+| `limit` | No | Maximum number of results to return |
+| `projectPath` | No | Filter by project path |
+
+## Example
+
+```bash
+bash config/skills/agent/recall/execute.sh '{"agentId":"dev-1","context":"authentication implementation patterns","scope":"project","limit":5}'
+```
+
+## Output
+
+JSON array of matching memory entries with content, category, scope, and timestamps.

package/config/skills/agent/core/recall/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-recall",
+  "name": "Recall",
+  "description": "Retrieve stored memories relevant to a given context or query.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["recall", "search memory", "remember what", "look up"],
+  "tags": ["memory", "recall", "search", "context"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/record-learning/execute.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Record a learning or insight for team knowledge sharing
+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 '{\"agentId\":\"dev-1\",\"agentRole\":\"developer\",\"projectPath\":\"/projects/app\",\"learning\":\"Jest mock resets are needed between tests\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+AGENT_ROLE=$(echo "$INPUT" | jq -r '.agentRole // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+LEARNING=$(echo "$INPUT" | jq -r '.learning // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "agentRole" "$AGENT_ROLE"
+require_param "projectPath" "$PROJECT_PATH"
+require_param "learning" "$LEARNING"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  agentRole: .agentRole,
+  projectPath: .projectPath,
+  learning: .learning
+} +
+  (if .relatedTask then {relatedTask: .relatedTask} else {} end) +
+  (if .relatedFiles then {relatedFiles: .relatedFiles} else {} end)')
+
+api_call POST "/memory/record-learning" "$BODY"

package/config/skills/agent/core/record-learning/instructions.md

@@ -0,0 +1,24 @@
+# Record Learning
+
+Record a learning or insight gained during task execution. These learnings are shared with the team and accumulated over time to improve future work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `agentRole` | Yes | Your role (e.g., `"developer"`, `"qa"`) |
+| `projectPath` | Yes | Absolute path to the project |
+| `learning` | Yes | Description of the learning or insight |
+| `relatedTask` | No | Path or ID of the task that triggered this learning |
+| `relatedFiles` | No | Array of file paths related to the learning |
+
+## Example
+
+```bash
+bash config/skills/agent/record-learning/execute.sh '{"agentId":"dev-1","agentRole":"developer","projectPath":"/projects/app","learning":"Jest mock resets are required between tests when using shared module mocks","relatedTask":"implement-auth-tests","relatedFiles":["src/auth.service.test.ts"]}'
+```
+
+## Output
+
+JSON confirmation that the learning was recorded.

package/config/skills/agent/core/record-learning/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-record-learning",
+  "name": "Record Learning",
+  "description": "Record a learning or insight gained during task execution for team knowledge sharing.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["record learning", "learned that", "new insight", "knowledge share"],
+  "tags": ["memory", "learning", "knowledge", "insight"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/register-self/execute.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Register an agent with the Crewly backend
+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 '{\"role\":\"developer\",\"sessionName\":\"dev-1\"}'"
+
+ROLE=$(echo "$INPUT" | jq -r '.role // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+require_param "role" "$ROLE"
+require_param "sessionName" "$SESSION_NAME"
+
+# Optional: claudeSessionId for resume support
+CLAUDE_SESSION_ID=$(echo "$INPUT" | jq -r '.claudeSessionId // empty')
+TEAM_MEMBER_ID=$(echo "$INPUT" | jq -r '.teamMemberId // empty')
+
+BODY=$(jq -n \
+  --arg role "$ROLE" \
+  --arg sessionName "$SESSION_NAME" \
+  --arg claudeSessionId "$CLAUDE_SESSION_ID" \
+  --arg teamMemberId "$TEAM_MEMBER_ID" \
+  '{role: $role, sessionName: $sessionName} +
+   (if $claudeSessionId != "" then {claudeSessionId: $claudeSessionId} else {} end) +
+   (if $teamMemberId != "" then {teamMemberId: $teamMemberId} else {} end)')
+
+api_call POST "/teams/members/register" "$BODY"

package/config/skills/agent/core/register-self/instructions.md

@@ -0,0 +1,18 @@
+# Register Self
+
+Register this agent as active with the Crewly backend. This must be the first skill you run on startup.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `role` | Yes | Agent role (e.g., "developer", "qa", "tpm") |
+| `sessionName` | Yes | Your session name (from your identity) |
+| `teamMemberId` | No | Your team member ID |
+| `claudeSessionId` | No | Claude session ID for resume support |
+
+## Example
+
+```bash
+bash config/skills/agent/register-self/execute.sh '{"role":"developer","sessionName":"dev-1"}'
+```

package/config/skills/agent/core/register-self/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-register-self",
+  "name": "Register Self",
+  "description": "Register the agent as active with the Crewly backend. Must be called on startup.",
+  "category": "system",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["register", "check in", "go online"],
+  "tags": ["system", "registration", "startup"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/remember/execute.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Store a memory entry for future recall
+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 '{\"agentId\":\"dev-1\",\"content\":\"The auth module uses JWT\",\"category\":\"architecture\",\"scope\":\"project\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
+CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
+SCOPE=$(echo "$INPUT" | jq -r '.scope // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "content" "$CONTENT"
+require_param "category" "$CATEGORY"
+require_param "scope" "$SCOPE"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  content: .content,
+  category: .category,
+  scope: .scope
+} +
+  (if .projectPath then {projectPath: .projectPath} else {} end) +
+  (if .metadata then {metadata: .metadata} else {} end)')
+
+api_call POST "/memory/remember" "$BODY"

package/config/skills/agent/core/remember/instructions.md

@@ -0,0 +1,24 @@
+# Remember
+
+Store a memory entry for future recall. Use this to persist important context, decisions, architectural findings, or patterns you discover during work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `content` | Yes | The content to remember |
+| `category` | Yes | Memory category (e.g., `"architecture"`, `"decision"`, `"pattern"`, `"bug"`) |
+| `scope` | Yes | Memory scope: `"project"`, `"team"`, or `"global"` |
+| `projectPath` | No | Associated project path |
+| `metadata` | No | Additional metadata object |
+
+## Example
+
+```bash
+bash config/skills/agent/remember/execute.sh '{"agentId":"dev-1","content":"Auth module uses JWT with 24h expiry. Refresh tokens stored in httpOnly cookies.","category":"architecture","scope":"project","projectPath":"/projects/app"}'
+```
+
+## Output
+
+JSON confirmation that the memory entry was stored.

package/config/skills/agent/core/remember/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-remember",
+  "name": "Remember",
+  "description": "Store a memory entry for future recall. Use this to persist important context, decisions, or findings.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["remember", "save memory", "store context", "note this"],
+  "tags": ["memory", "persistence", "context"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/report-progress/execute.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Report progress on the current task
+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\":\"dev-1\",\"progress\":50,\"current\":\"Implementing tests\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+PROGRESS=$(echo "$INPUT" | jq -r '.progress // empty')
+CURRENT=$(echo "$INPUT" | jq -r '.current // empty')
+require_param "sessionName" "$SESSION_NAME"
+require_param "progress" "$PROGRESS"
+require_param "current" "$CURRENT"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  sessionName: .sessionName,
+  progress: (.progress | tonumber),
+  current: .current
+} +
+  (if .completed then {completed: .completed} else {} end) +
+  (if .nextSteps then {nextSteps: .nextSteps} else {} end) +
+  (if .blockers then {blockers: .blockers} else {} end) +
+  (if .ticketId then {ticketId: .ticketId} else {} end)')
+
+api_call POST "/task-management/sync" "$BODY"

package/config/skills/agent/core/report-progress/instructions.md

@@ -0,0 +1,25 @@
+# Report Progress
+
+Report progress on your current task. Includes a completion percentage, what you are currently working on, completed items, and next steps.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | Your agent session name |
+| `progress` | Yes | Completion percentage (0-100) |
+| `current` | Yes | Description of what you are currently working on |
+| `completed` | No | Array of completed items |
+| `nextSteps` | No | Description of planned next steps |
+| `blockers` | No | Description of any blockers encountered |
+| `ticketId` | No | Associated ticket or task ID |
+
+## Example
+
+```bash
+bash config/skills/agent/report-progress/execute.sh '{"sessionName":"dev-1","progress":60,"current":"Writing unit tests","completed":["Implemented API endpoint","Added validation"],"nextSteps":"Integration tests and code review","blockers":""}'
+```
+
+## Output
+
+JSON confirmation that the progress report has been recorded.

package/config/skills/agent/core/report-progress/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-report-progress",
+  "name": "Report Progress",
+  "description": "Report progress on the current task with percentage, completed items, and next steps.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["report progress", "status update", "progress update", "sync status"],
+  "tags": ["task", "progress", "status", "sync"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/report-status/execute.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Report task status to the orchestrator
+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\":\"dev-1\",\"status\":\"done\",\"summary\":\"Finished implementing auth module\",\"taskPath\":\"/path/to/task.md\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+STATUS=$(echo "$INPUT" | jq -r '.status // empty')
+SUMMARY=$(echo "$INPUT" | jq -r '.summary // empty')
+TASK_PATH=$(echo "$INPUT" | jq -r '.taskPath // empty')
+require_param "sessionName" "$SESSION_NAME"
+require_param "status" "$STATUS"
+require_param "summary" "$SUMMARY"
+
+# Build the message the orchestrator will receive
+STATUS_UPPER=$(echo "$STATUS" | tr '[:lower:]' '[:upper:]')
+MESSAGE="[${STATUS_UPPER}] Agent ${SESSION_NAME}: ${SUMMARY}"
+
+# Send the status message to the orchestrator session via the chat API
+BODY=$(jq -n --arg content "$MESSAGE" --arg senderName "$SESSION_NAME" \
+  '{content: $content, senderName: $senderName, senderType: "agent"}')
+
+api_call POST "/chat/agent-response" "$BODY"
+
+# If task is done and taskPath provided, move task file to done folder
+if [ "$STATUS" = "done" ] && [ -n "$TASK_PATH" ]; then
+  COMPLETE_BODY=$(jq -n \
+    --arg taskPath "$TASK_PATH" \
+    --arg sessionName "$SESSION_NAME" \
+    '{taskPath: $taskPath, sessionName: $sessionName}')
+  api_call POST "/task-management/complete" "$COMPLETE_BODY" || true
+fi

package/config/skills/agent/core/report-status/instructions.md

@@ -0,0 +1,36 @@
+# Report Status
+
+Proactively notify the orchestrator when a task is done, blocked, or failed. Use this skill to keep the orchestrator informed without waiting for a scheduled check-in.
+
+When `status` is `done` and a `taskPath` is provided, the task file is automatically moved from `in_progress/` to `done/` in the project's `.crewly/tasks/` directory.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | Your agent session name |
+| `status` | Yes | Current status: `done`, `blocked`, or `failed` |
+| `summary` | Yes | Brief description of what happened or what is needed |
+| `taskPath` | No | Path to the task MD file; when provided with `status=done`, moves it to the `done/` folder |
+
+## Example
+
+```bash
+bash config/skills/agent/report-status/execute.sh '{"sessionName":"dev-1","status":"done","summary":"Finished implementing auth module and all tests pass","taskPath":"/path/to/project/.crewly/tasks/delegated/in_progress/implement_auth_1234.md"}'
+```
+
+### Reporting a blocker
+
+```bash
+bash config/skills/agent/report-status/execute.sh '{"sessionName":"dev-1","status":"blocked","summary":"Waiting on API credentials from ops team"}'
+```
+
+### Reporting a failure
+
+```bash
+bash config/skills/agent/report-status/execute.sh '{"sessionName":"dev-1","status":"failed","summary":"Build fails due to missing dependency in package.json"}'
+```
+
+## Output
+
+JSON confirmation that the status notification was sent to the orchestrator. If `taskPath` was provided with `done` status, also returns the task completion result.

package/config/skills/agent/core/report-status/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-report-status",
+  "name": "Report Status",
+  "description": "Proactively notify the orchestrator when a task is done, blocked, or failed.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["report status", "notify orchestrator", "task done", "task blocked", "task failed"],
+  "tags": ["task", "status", "notification", "orchestrator"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/send-chat-response/execute.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Send a chat response visible in the Crewly chat UI
+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 '{\"content\":\"Task completed successfully\",\"senderName\":\"dev-1\"}'"
+
+CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
+SENDER_NAME=$(echo "$INPUT" | jq -r '.senderName // empty')
+SENDER_TYPE=$(echo "$INPUT" | jq -r '.senderType // empty')
+CONVERSATION_ID=$(echo "$INPUT" | jq -r '.conversationId // empty')
+require_param "content" "$CONTENT"
+require_param "senderName" "$SENDER_NAME"
+
+BODY=$(jq -n \
+  --arg content "$CONTENT" \
+  --arg senderName "$SENDER_NAME" \
+  --arg senderType "$SENDER_TYPE" \
+  --arg conversationId "$CONVERSATION_ID" \
+  '{content: $content, senderName: $senderName} +
+   (if $senderType != "" then {senderType: $senderType} else {} end) +
+   (if $conversationId != "" then {conversationId: $conversationId} else {} end)')
+
+api_call POST "/chat/agent-response" "$BODY"

package/config/skills/agent/core/send-chat-response/instructions.md

@@ -0,0 +1,22 @@
+# Send Chat Response
+
+Send a chat response that appears in the Crewly chat UI. Use this to communicate results, status updates, or answers directly to the user.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `content` | Yes | The message content to display in chat |
+| `senderName` | Yes | Your agent name (displayed as the message sender) |
+| `senderType` | No | Sender type (e.g., `"agent"`, `"system"`) |
+| `conversationId` | No | Target conversation ID. Uses the active conversation if omitted |
+
+## Example
+
+```bash
+bash config/skills/agent/send-chat-response/execute.sh '{"content":"Login feature implemented and all tests passing.","senderName":"dev-1"}'
+```
+
+## Output
+
+JSON confirmation that the chat message was delivered.

package/config/skills/agent/core/send-chat-response/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-send-chat-response",
+  "name": "Send Chat Response",
+  "description": "Send a chat response visible in the Crewly chat UI.",
+  "category": "communication",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["send chat", "reply chat", "chat response", "respond to user"],
+  "tags": ["chat", "communication", "response"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/send-message/execute.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Send a direct message to another 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 '{\"to\":\"agent-session\",\"message\":\"Can you review my PR?\"}'"
+
+TO=$(echo "$INPUT" | jq -r '.to // empty')
+MESSAGE=$(echo "$INPUT" | jq -r '.message // empty')
+require_param "to" "$TO"
+require_param "message" "$MESSAGE"
+
+BODY=$(jq -n --arg data "$MESSAGE" --arg mode "message" '{data: $data, mode: $mode}')
+
+api_call POST "/terminal/${TO}/write" "$BODY"

package/config/skills/agent/core/send-message/instructions.md

@@ -0,0 +1,20 @@
+# Send Message
+
+Send a direct message to another agent's terminal session. The message is written to the target agent's PTY using the two-step message mode for reliable delivery.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `to` | Yes | Target agent's PTY session name |
+| `message` | Yes | The message text to send |
+
+## Example
+
+```bash
+bash config/skills/agent/send-message/execute.sh '{"to":"qa-1","message":"PR #42 is ready for review. I added unit tests for the auth module."}'
+```
+
+## Output
+
+JSON confirmation of message delivery.

package/config/skills/agent/core/send-message/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-send-message",
+  "name": "Send Message",
+  "description": "Send a direct message to another agent's terminal session.",
+  "category": "communication",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["send message", "message agent", "tell agent", "dm agent"],
+  "tags": ["communication", "agent", "message", "terminal"],
+  "version": "1.0.0"
+}