crewly 1.3.31 → 1.4.0

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

@@ -0,0 +1,58 @@
+---
+name: Send Message
+description: "Send a direct message to another agent's terminal session."
+version: 1.0.0
+category: communication
+skillType: claude-skill
+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
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
+# 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/update-team-norm/execute.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+# Create or update a team norm/SOP file
+# Writes to ~/.crewly/teams/{teamId}/norms/{normId}.md
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+CREWLY_HOME="${HOME}/.crewly"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"normId\":\"code-commit\",\"title\":\"Code Commit SOP\",\"content\":\"...\"}'"
+
+NORM_ID=$(echo "$INPUT" | jq -r '.normId // empty')
+TITLE=$(echo "$INPUT" | jq -r '.title // empty')
+TRIGGER=$(echo "$INPUT" | jq -r '.trigger // empty')
+CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
+APPEND=$(echo "$INPUT" | jq -r '.append // "false"')
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+UPDATED_BY=$(echo "$INPUT" | jq -r '.updatedBy // empty')
+
+require_param "normId" "$NORM_ID"
+require_param "content" "$CONTENT"
+
+# Resolve teamId: explicit param > lookup by sessionName > CREWLY_SESSION_NAME env
+resolve_team_id() {
+  local session="${1:-${CREWLY_SESSION_NAME:-}}"
+  [ -z "$session" ] && return 1
+  local teams_dir="${CREWLY_HOME}/teams"
+  [ ! -d "$teams_dir" ] && return 1
+  for config in "$teams_dir"/*/config.json; do
+    [ -f "$config" ] || continue
+    local found
+    found=$(jq -r --arg s "$session" '.members[]? | select(.sessionName == $s) | "found"' "$config" 2>/dev/null | head -1)
+    if [ "$found" = "found" ]; then
+      basename "$(dirname "$config")"
+      return 0
+    fi
+  done
+  return 1
+}
+
+if [ -z "$TEAM_ID" ]; then
+  TEAM_ID=$(resolve_team_id "$SESSION_NAME") || error_exit "Could not resolve teamId. Provide teamId or sessionName."
+fi
+
+NORMS_DIR="${CREWLY_HOME}/teams/${TEAM_ID}/norms"
+mkdir -p "$NORMS_DIR"
+
+NORM_FILE="${NORMS_DIR}/${NORM_ID}.md"
+TODAY=$(date +%Y-%m-%d)
+ACTION="created"
+
+if [ -f "$NORM_FILE" ]; then
+  ACTION="updated"
+
+  # Read existing frontmatter values as defaults
+  EXISTING_TITLE=$(sed -n '/^---$/,/^---$/{ /^---$/d; s/^title: *//p; }' "$NORM_FILE" | head -1)
+  EXISTING_TRIGGER=$(sed -n '/^---$/,/^---$/{ /^---$/d; s/^trigger: *//p; }' "$NORM_FILE" | head -1)
+  EXISTING_UPDATED_BY=$(sed -n '/^---$/,/^---$/{ /^---$/d; s/^updatedBy: *//p; }' "$NORM_FILE" | head -1)
+
+  # Use existing values as fallbacks
+  [ -z "$TITLE" ] && TITLE="$EXISTING_TITLE"
+  [ -z "$TRIGGER" ] && TRIGGER="$EXISTING_TRIGGER"
+  [ -z "$UPDATED_BY" ] && UPDATED_BY="$EXISTING_UPDATED_BY"
+
+  # Handle append mode
+  if [ "$APPEND" = "true" ]; then
+    # Extract existing content (everything after second ---)
+    EXISTING_CONTENT=""
+    FM_DONE=false
+    FM_COUNT=0
+    while IFS= read -r line || [ -n "$line" ]; do
+      if [ "$line" = "---" ]; then
+        FM_COUNT=$((FM_COUNT + 1))
+        if [ "$FM_COUNT" -ge 2 ]; then
+          FM_DONE=true
+          continue
+        fi
+      elif [ "$FM_DONE" = true ]; then
+        EXISTING_CONTENT="${EXISTING_CONTENT}${line}
+"
+      fi
+    done < "$NORM_FILE"
+
+    # Trim leading blank lines from existing content
+    EXISTING_CONTENT=$(echo "$EXISTING_CONTENT" | sed '/./,$!d')
+
+    CONTENT="${EXISTING_CONTENT}
+${CONTENT}"
+  fi
+else
+  # New file: title is required
+  [ -z "$TITLE" ] && error_exit "title is required when creating a new norm"
+fi
+
+# Build the norm file
+{
+  echo "---"
+  echo "title: ${TITLE}"
+  [ -n "$TRIGGER" ] && echo "trigger: ${TRIGGER}"
+  [ -n "$UPDATED_BY" ] && echo "updatedBy: ${UPDATED_BY}"
+  echo "updatedAt: ${TODAY}"
+  echo "---"
+  echo ""
+  echo "$CONTENT"
+} > "$NORM_FILE"
+
+jq -n \
+  --arg normId "$NORM_ID" \
+  --arg title "$TITLE" \
+  --arg trigger "$TRIGGER" \
+  --arg action "$ACTION" \
+  --arg path "$NORM_FILE" \
+  '{success: true, action: $action, normId: $normId, title: $title, trigger: $trigger, path: $path}'

package/config/skills/agent/desktop-app-control/{instructions.md → SKILL.md}

@@ -1,3 +1,45 @@
+---
+name: Desktop App Control (agent-browser)
+description: "Control desktop Electron apps and Chrome-based browsers via agent-browser (Vercel Labs). Uses CDP (Chrome DevTools Protocol) with accessibility snapshots and ref-based interaction \u2014 82-96% token savings vs raw Playwright. Supports VS Code, Slack, Discord, Notion, Figma, Spotify, Chrome, and any Electron app."
+version: 1.0.0
+category: automation
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - generalist
+  - designer
+  - qa
+triggers:
+  - desktop app
+  - electron
+  - browser control
+  - agent-browser
+  - slack control
+  - vscode control
+  - notion control
+  - discord control
+  - chrome control
+  - cdp
+  - accessibility snapshot
+  - desktop automation
+tags:
+  - automation
+  - desktop
+  - electron
+  - cdp
+  - agent-browser
+  - browser
+  - playwright
+  - accessibility
+  - snapshot
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
 # Desktop App Control (agent-browser)
 
 Control Electron desktop apps and Chrome browsers using [agent-browser](https://github.com/vercel-labs/agent-browser) by Vercel Labs. Uses accessibility snapshots with ref-based interaction for 82-96% token savings.

package/config/skills/agent/trend-monitor/{instructions.md → SKILL.md}

@@ -1,3 +1,37 @@
+---
+name: Trend Monitor
+description: Monitor and store trending topics from X, Google Trends, Hacker News, Product Hunt, Reddit, and GitHub. Save browser-extracted trends, query latest data, and get AI-filtered topic suggestions for content planning.
+version: 1.0.0
+category: content
+skillType: claude-skill
+assignableRoles:
+  - content-strategist
+  - product-manager
+  - generalist
+triggers:
+  - trending topics
+  - what is trending
+  - trend monitor
+  - hot topics
+  - content ideas
+  - topic suggestions
+tags:
+  - trends
+  - monitoring
+  - content
+  - social-media
+  - hackernews
+  - producthunt
+  - x-twitter
+  - marketing
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Trend Monitor
 
 Monitor trending topics across platforms using browser automation, then store and query them for content planning.

package/config/skills/agent/vnc-browser/{instructions.md → SKILL.md}

@@ -1,3 +1,41 @@
+---
+name: VNC Remote Browser Access
+description: Launch a virtual display with VNC + noVNC + cloudflared for remote browser viewing and control. Enables human-in-the-loop login/verification when Playwright needs manual interaction.
+version: 1.0.0
+category: browser
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - qa-engineer
+  - fullstack-dev
+  - backend-developer
+  - frontend-developer
+  - generalist
+triggers:
+  - vnc
+  - remote browser
+  - browser login
+  - manual login
+  - human verification
+  - captcha
+  - 2fa
+  - playwright headful
+tags:
+  - vnc
+  - browser
+  - remote-access
+  - playwright
+  - noVNC
+  - cloudflared
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
 # VNC Remote Browser Access
 
 Bridge macOS Screen Sharing to a public HTTPS URL via noVNC + cloudflared. This lets humans remotely view and control the Mac desktop (and any browser on it) from anywhere — essential when Playwright hits a login page, CAPTCHA, or 2FA prompt.

package/config/skills/auditor/score-task/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: Score Task
+description: "Score a completed task's quality (0-100) for tracking per-agent quality metrics."
+triggers:
+  - score task
+  - quality score
+  - rate task
+---
+
+# Score Task
+
+Assigns a quality score (0-100) to a completed task for per-agent quality tracking.
+
+## Usage
+
+```bash
+bash config/skills/auditor/score-task/execute.sh '{"taskId":"task-123","qualityScore":85}'
+```
+
+## Parameters
+
+- `taskId` (required): ID of the completed task to score
+- `qualityScore` (required): Quality score between 0 and 100
+- `sessionName` (optional): Session name of the scorer (defaults to "auditor")
+
+## Output
+
+JSON response confirming the score was recorded.

package/config/skills/auditor/score-task/execute.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Score a completed task's quality for per-agent quality tracking (#174)
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+INPUT="${1:-{}}"
+TASK_ID=$(echo "$INPUT" | jq -r '.taskId // empty')
+QUALITY_SCORE=$(echo "$INPUT" | jq -r '.qualityScore // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+
+require_param "taskId" "$TASK_ID"
+require_param "qualityScore" "$QUALITY_SCORE"
+
+BODY=$(jq -n \
+  --arg taskId "$TASK_ID" \
+  --argjson qualityScore "$QUALITY_SCORE" \
+  --arg scoredBy "${SESSION_NAME:-auditor}" \
+  '{taskId: $taskId, qualityScore: $qualityScore, scoredBy: $scoredBy}')
+
+api_call POST "/tasks/score" "$BODY"

package/config/skills/examples/enterprise-skill-example.json

@@ -0,0 +1,22 @@
+{
+  "id": "compliance-checker",
+  "name": "Compliance Checker",
+  "description": "Automated compliance verification against SOC 2, HIPAA, GDPR, and custom enterprise policies",
+  "category": "quality",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 120000
+    }
+  },
+  "assignableRoles": ["team-leader", "qa-engineer"],
+  "triggers": ["compliance", "audit", "SOC 2", "HIPAA", "GDPR"],
+  "tags": ["compliance", "enterprise", "audit", "security"],
+  "version": "1.0.0",
+  "requiredTier": "enterprise",
+  "fallbackSkill": null
+}

package/config/skills/examples/premium-skill-example.json

@@ -0,0 +1,22 @@
+{
+  "id": "advanced-code-review",
+  "name": "Advanced Code Review",
+  "description": "AI-powered deep code review with security analysis, performance profiling, and architectural pattern detection",
+  "category": "quality",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 60000
+    }
+  },
+  "assignableRoles": ["developer", "team-leader", "qa-engineer"],
+  "triggers": ["code review", "pull request", "PR review", "security review"],
+  "tags": ["code-quality", "security", "performance", "premium"],
+  "version": "1.0.0",
+  "requiredTier": "pro",
+  "fallbackSkill": "code-review"
+}

package/config/skills/orchestrator/assign-task/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Assign Task
+description: Assign a task to an agent via the task management system.
+version: 1.0.0
+category: management
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - assign task
+  - give task
+  - task assignment
+tags:
+  - task
+  - assignment
+  - management
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
+# Assign Task
+
+Assign a task to an agent via the task management system.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/assign-task/execute.sh '{"taskId":"task-123","assignee":"agent-joe"}'
+```
+
+## Parameters
+
+Pass the full JSON body as expected by `POST /api/task-management/assign`.
+
+## Output
+
+JSON confirmation of task assignment.

package/config/skills/orchestrator/assign-team-to-project/{instructions.md → SKILL.md}

@@ -1,3 +1,28 @@
+---
+name: Assign Team to Project
+description: Assign one or more teams to a project so agents can work on it.
+version: 1.0.0
+category: management
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - assign team
+  - assign team to project
+  - link team to project
+tags:
+  - project
+  - team
+  - assignment
+  - management
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
 # Assign Team to Project
 
 Assigns one or more teams to a project. Teams must be assigned to a project before they can be started.

package/config/skills/orchestrator/broadcast/{instructions.md → SKILL.md}

@@ -1,3 +1,27 @@
+---
+name: Broadcast
+description: Send a message to all active agent sessions.
+version: 1.0.0
+category: communication
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - broadcast
+  - message all
+  - announce
+tags:
+  - communication
+  - broadcast
+  - team
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
 # Broadcast
 
 Sends a message to all active agent sessions (excluding the orchestrator itself).

package/config/skills/orchestrator/broadcast-to-org/{instructions.md → SKILL.md}

@@ -1,3 +1,28 @@
+---
+name: Broadcast to Organization
+description: Send a message to all Team Leaders within a specific organization (parent team and its child teams).
+version: 1.0.0
+category: communication
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - broadcast to org
+  - message org leaders
+  - notify organization
+tags:
+  - communication
+  - broadcast
+  - organization
+  - hierarchy
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
 # Broadcast to Organization
 
 Send a message to all Team Leaders within a specific organization. Given a parent team ID, this skill finds all child teams, identifies their leaders, and delivers the message to each leader's session.

package/config/skills/orchestrator/cancel-all-schedules/{instructions.md → SKILL.md}

@@ -1,3 +1,8 @@
+---
+name: cancel-all-schedules
+description: Cancel all active scheduled checks. Optionally filter by session or age.
+---
+
 # cancel-all-schedules
 
 Cancel all active scheduled checks with optional filters.

package/config/skills/orchestrator/cancel-schedule/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: Cancel Schedule
+description: Cancel a previously scheduled check.
+version: 1.0.0
+category: monitoring
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - cancel schedule
+  - cancel reminder
+  - remove check
+tags:
+  - scheduling
+  - monitoring
+  - cancellation
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
+# Cancel Schedule
+
+Cancel a previously scheduled check.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/cancel-schedule/execute.sh '{"scheduleId":"sched-abc123"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `scheduleId` | Yes | The schedule ID to cancel |
+
+## Output
+
+JSON confirmation of cancellation.

package/config/skills/orchestrator/complete-task/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Complete Task
+description: Mark a task as complete in the task management system.
+version: 1.0.0
+category: management
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - complete task
+  - finish task
+  - task done
+tags:
+  - task
+  - completion
+  - management
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
+# Complete Task
+
+Mark a task as complete in the task management system.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/complete-task/execute.sh '{"taskId":"task-123","result":"success"}'
+```
+
+## Parameters
+
+Pass the full JSON body as expected by `POST /api/task-management/complete`.
+
+## Output
+
+JSON confirmation of task completion.

package/config/skills/orchestrator/create-project/{instructions.md → SKILL.md}

@@ -1,3 +1,27 @@
+---
+name: Create Project
+description: Create a new project in Crewly with a path, name, and description.
+version: 1.0.0
+category: management
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - create project
+  - new project
+  - set up project
+tags:
+  - project
+  - management
+  - creation
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
 # Create Project
 
 Creates a new project in Crewly with a specified filesystem path, display name, and optional description.

package/config/skills/orchestrator/create-team/{instructions.md → SKILL.md}

@@ -1,3 +1,27 @@
+---
+name: Create Team
+description: Create a new agent team with members.
+version: 1.0.0
+category: management
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+triggers:
+  - create team
+  - new team
+  - set up team
+tags:
+  - team
+  - management
+  - creation
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
 # Create Team
 
 Creates a new agent team with optional members.