crewly 1.0.0

package/config/skills/nano-banana-image/.env

@@ -0,0 +1,2 @@
+# Nano Banana Image Generation API Configuration
+GEMINI_API_KEY=AIzaSyDWVSRxr0e9JkKBkq-Tkdy5fBEs0_HCJ-8

package/config/skills/nano-banana-image/.env.example

@@ -0,0 +1,6 @@
+# Nano Banana Image Generation API Configuration
+# Copy this file to .env and add your API key
+
+# Google Gemini API Key (required)
+# Get your key at: https://aistudio.google.com/apikey
+GEMINI_API_KEY=your_api_key_here

package/config/skills/nano-banana-image/generate.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# Nano Banana Image Generation Script
+# This script calls the Gemini API to generate images
+# Supports both standard (flash) and pro models
+
+set -e
+
+# Check for required environment variable
+if [ -z "$GEMINI_API_KEY" ]; then
+    echo "Error: GEMINI_API_KEY environment variable is not set"
+    exit 1
+fi
+
+# Model selection
+# Usage: generate.sh [prompt] [--pro]
+#   --pro    Use gemini-3-pro-image-preview (higher quality)
+#   default  Use gemini-2.0-flash-exp-image-generation (faster)
+MODEL="gemini-2.0-flash-exp-image-generation"
+PROMPT=""
+
+for arg in "$@"; do
+    if [ "$arg" = "--pro" ]; then
+        MODEL="gemini-3-pro-image-preview"
+    elif [ -z "$PROMPT" ]; then
+        PROMPT="$arg"
+    fi
+done
+
+if [ -z "$PROMPT" ]; then
+    read -r PROMPT
+fi
+
+if [ -z "$PROMPT" ]; then
+    echo "Error: No prompt provided"
+    exit 1
+fi
+
+# API endpoint
+API_URL="https://generativelanguage.googleapis.com/v1beta/models/${MODEL}:generateContent"
+
+# Create the request payload
+PAYLOAD=$(cat <<EOF
+{
+  "contents": [
+    {
+      "parts": [
+        {
+          "text": "Generate an image: $PROMPT"
+        }
+      ]
+    }
+  ],
+  "generationConfig": {
+    "responseModalities": ["Text", "Image"]
+  }
+}
+EOF
+)
+
+# Make the API call
+RESPONSE=$(curl -s -X POST "$API_URL?key=$GEMINI_API_KEY" \
+    -H "Content-Type: application/json" \
+    -d "$PAYLOAD")
+
+# Check for errors
+if echo "$RESPONSE" | grep -q '"error"'; then
+    echo "API Error:"
+    echo "$RESPONSE" | jq -r '.error.message // .error'
+    exit 1
+fi
+
+# Output the response
+echo "$RESPONSE"

package/config/skills/nano-banana-image/instructions.md

@@ -0,0 +1,50 @@
+# Nano Banana Image Generation
+
+This skill enables AI image generation through Google's Gemini API.
+
+## Overview
+
+The Nano Banana Image Generation skill allows agents to create images from text descriptions using Google's Gemini model. This is useful for:
+
+- Creating concept art and visualizations
+- Generating placeholder images for designs
+- Producing custom graphics based on descriptions
+- Rapid prototyping of visual content
+
+## Usage
+
+To generate an image, provide a detailed text description of what you want to create.
+
+### Example Prompts
+
+- "A futuristic cityscape at sunset with flying cars"
+- "A cozy coffee shop interior with warm lighting"
+- "An abstract representation of music and sound waves"
+
+## API Configuration
+
+This skill requires a Gemini API key to function. The API key should be stored in the skill's `.env` file:
+
+```
+GEMINI_API_KEY=your_api_key_here
+```
+
+### Getting an API Key
+
+1. Visit [Google AI Studio](https://aistudio.google.com/apikey)
+2. Sign in with your Google account
+3. Create a new API key
+4. Copy the key and add it to the skill configuration
+
+## Best Practices
+
+- Be specific and detailed in your image descriptions
+- Include style preferences (realistic, artistic, minimalist, etc.)
+- Specify desired colors, lighting, and mood
+- Mention any specific elements that must be included
+
+## Limitations
+
+- Image generation may take 30-60 seconds
+- Some content types may be restricted by the API
+- Results may vary based on prompt complexity

package/config/skills/nano-banana-image/skill.json

@@ -0,0 +1,39 @@
+{
+  "id": "nano-banana-image",
+  "name": "Nano Banana Image Generation",
+  "description": "Generate images using Google's Gemini Nano Banana API. Supports standard (flash) and pro models. Use --pro flag for higher quality output with gemini-3-pro-image-preview.",
+  "category": "design",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "generate.sh",
+      "interpreter": "bash",
+      "timeoutMs": 120000
+    }
+  },
+  "environment": {
+    "file": ".env",
+    "required": ["GEMINI_API_KEY"]
+  },
+  "notices": [
+    {
+      "type": "requirement",
+      "title": "API Key Required",
+      "message": "This skill requires a Gemini API key. Add your API key in the skill settings.",
+      "link": "https://aistudio.google.com/apikey",
+      "linkText": "Get API Key"
+    }
+  ],
+  "triggers": ["generate image", "create image", "nano banana", "gemini image", "ai image"],
+  "models": {
+    "standard": "gemini-2.0-flash-exp-image-generation",
+    "pro": "gemini-3-pro-image-preview"
+  },
+  "tags": ["image", "generation", "ai", "gemini", "api", "pro"],
+  "assignableRoles": ["designer"],
+  "version": "1.1.0",
+  "createdAt": "2024-01-01T00:00:00.000Z",
+  "updatedAt": "2024-01-01T00:00:00.000Z"
+}

package/config/skills/orchestrator/_common/lib.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# Orchestrator Skills Common Library - delegates to shared library
+SHARED_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)/_common"
+source "${SHARED_LIB_DIR}/lib.sh"

package/config/skills/orchestrator/assign-task/execute.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# Assign a task to an agent via the task management system
+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 '{\"taskId\":\"...\",\"assignee\":\"agent-session\"}'"
+
+# Pass the full input as the request body
+api_call POST "/task-management/assign" "$INPUT"

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

@@ -0,0 +1,17 @@
+# 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-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-assign-task",
+  "name": "Assign Task",
+  "description": "Assign a task to an agent via the task management system.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["assign task", "give task", "task assignment"],
+  "tags": ["task", "assignment", "management"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/assign-team-to-project/execute.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Assign teams to a project
+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 '{\"projectId\":\"project-uuid\",\"teamIds\":[\"team-uuid-1\"]}'"
+
+PROJECT_ID=$(echo "$INPUT" | jq -r '.projectId // empty')
+require_param "projectId" "$PROJECT_ID"
+
+# Pass the full input as the request body (backend expects teamIds array)
+api_call POST "/projects/${PROJECT_ID}/teams" "$INPUT"

package/config/skills/orchestrator/assign-team-to-project/instructions.md

@@ -0,0 +1,20 @@
+# Assign Team to Project
+
+Assigns one or more teams to a project. Teams must be assigned to a project before they can be started.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/assign-team-to-project/execute.sh '{"projectId":"project-uuid","teamIds":["team-uuid-1"]}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `projectId` | Yes | UUID of the target project |
+| `teamIds` | Yes | Array of team UUIDs to assign to the project |
+
+## Output
+
+JSON confirming the team assignment.

package/config/skills/orchestrator/assign-team-to-project/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-assign-team-to-project",
+  "name": "Assign Team to Project",
+  "description": "Assign one or more teams to a project so agents can work on it.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["assign team", "assign team to project", "link team to project"],
+  "tags": ["project", "team", "assignment", "management"],
+  "version": "1.0.0"
+}

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

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Broadcast a message to all active agent sessions
+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 '{\"message\":\"Team standup in 5 minutes\"}'"
+
+MESSAGE=$(echo "$INPUT" | jq -r '.message // empty')
+require_param "message" "$MESSAGE"
+
+# Get all active sessions
+SESSIONS=$(api_call GET "/terminal/sessions" 2>/dev/null) || error_exit "Failed to get sessions"
+
+# Extract session names and send to each
+NAMES=$(echo "$SESSIONS" | jq -r '.data // . | if type == "array" then .[].name else empty end' 2>/dev/null)
+
+RESULTS="[]"
+SENT=0
+FAILED=0
+
+for NAME in $NAMES; do
+  # Skip orchestrator's own session
+  [ "$NAME" = "crewly-orc" ] && continue
+
+  BODY=$(jq -n --arg message "$MESSAGE" '{message: $message}')
+  if api_call POST "/terminal/${NAME}/deliver" "$BODY" >/dev/null 2>&1; then
+    SENT=$((SENT + 1))
+  else
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+echo "{\"sent\":${SENT},\"failed\":${FAILED},\"message\":\"Broadcast complete\"}"

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

@@ -0,0 +1,19 @@
+# Broadcast
+
+Sends a message to all active agent sessions (excluding the orchestrator itself).
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/broadcast/execute.sh '{"message":"Team standup in 5 minutes"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `message` | Yes | The message to broadcast |
+
+## Output
+
+JSON with count of sent/failed deliveries.

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

@@ -0,0 +1,20 @@
+{
+  "id": "orc-broadcast",
+  "name": "Broadcast",
+  "description": "Send a message to all active agent sessions.",
+  "category": "communication",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 60000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["broadcast", "message all", "announce"],
+  "tags": ["communication", "broadcast", "team"],
+  "version": "1.0.0"
+}

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

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Cancel a scheduled check by ID
+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 '{\"scheduleId\":\"sched-123\"}'"
+
+SCHEDULE_ID=$(echo "$INPUT" | jq -r '.scheduleId // empty')
+require_param "scheduleId" "$SCHEDULE_ID"
+
+api_call DELETE "/schedule/${SCHEDULE_ID}"

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

@@ -0,0 +1,19 @@
+# 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/cancel-schedule/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-cancel-schedule",
+  "name": "Cancel Schedule",
+  "description": "Cancel a previously scheduled check.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["cancel schedule", "cancel reminder", "remove check"],
+  "tags": ["scheduling", "monitoring", "cancellation"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/complete-task/execute.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Mark a task as complete via the task management system
+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 '{\"taskId\":\"...\",\"result\":\"success\"}'"
+
+api_call POST "/task-management/complete" "$INPUT"

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

@@ -0,0 +1,17 @@
+# 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/complete-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-complete-task",
+  "name": "Complete Task",
+  "description": "Mark a task as complete in the task management system.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["complete task", "finish task", "task done"],
+  "tags": ["task", "completion", "management"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/create-project/execute.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Create a new project in Crewly
+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 '{\"path\":\"/absolute/path/to/project\",\"name\":\"My Project\",\"description\":\"...\"}'"
+
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.path // empty')
+require_param "path" "$PROJECT_PATH"
+
+# Pass the full input as the request body (backend expects path, name, description)
+api_call POST "/projects" "$INPUT"

package/config/skills/orchestrator/create-project/instructions.md

@@ -0,0 +1,21 @@
+# Create Project
+
+Creates a new project in Crewly with a specified filesystem path, display name, and optional description.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/create-project/execute.sh '{"path":"/absolute/path/to/project","name":"My Project","description":"A web application"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `path` | Yes | Absolute filesystem path to the project directory |
+| `name` | No | Human-readable project name |
+| `description` | No | Brief description of the project |
+
+## Output
+
+JSON with the created project details including project ID.

package/config/skills/orchestrator/create-project/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "orc-create-project",
+  "name": "Create Project",
+  "description": "Create a new project in Crewly with a path, name, and description.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["create project", "new project", "set up project"],
+  "tags": ["project", "management", "creation"],
+  "version": "1.0.0"
+}

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

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Create a new agent 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 '{\"name\":\"Alpha\",\"description\":\"...\",\"members\":[{\"name\":\"dev1\",\"role\":\"developer\"}]}'"
+
+NAME=$(echo "$INPUT" | jq -r '.name // empty')
+require_param "name" "$NAME"
+
+# Pass the full input as the request body (backend expects name, description, members)
+api_call POST "/teams" "$INPUT"

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

@@ -0,0 +1,21 @@
+# Create Team
+
+Creates a new agent team with optional members.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/create-team/execute.sh '{"name":"Alpha","description":"Frontend team","members":[{"name":"dev1","role":"developer"}]}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `name` | Yes | Team name |
+| `description` | No | Team description |
+| `members` | No | Array of `{name, role}` objects |
+
+## Output
+
+JSON with the created team details including team ID.

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

@@ -0,0 +1,20 @@
+{
+  "id": "orc-create-team",
+  "name": "Create Team",
+  "description": "Create a new agent team with members.",
+  "category": "management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["orchestrator"],
+  "triggers": ["create team", "new team", "set up team"],
+  "tags": ["team", "management", "creation"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/delegate-task/execute.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Delegate a task to an agent with a structured task template
+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\",\"task\":\"implement feature X\",\"priority\":\"high\",\"projectPath\":\"/path/to/project\"}'"
+
+TO=$(echo "$INPUT" | jq -r '.to // empty')
+TASK=$(echo "$INPUT" | jq -r '.task // empty')
+PRIORITY=$(echo "$INPUT" | jq -r '.priority // "normal"')
+CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+require_param "to" "$TO"
+require_param "task" "$TASK"
+
+# Build a structured task message
+TASK_MESSAGE="[TASK] Priority: ${PRIORITY}\n\n${TASK}"
+[ -n "$CONTEXT" ] && TASK_MESSAGE="${TASK_MESSAGE}\n\nContext: ${CONTEXT}"
+TASK_MESSAGE="${TASK_MESSAGE}\n\nWhen done, report back using: bash config/skills/agent/report-status/execute.sh '{\"sessionName\":\"${TO}\",\"status\":\"done\",\"summary\":\"<brief summary>\"}'"
+
+BODY=$(jq -n --arg message "$TASK_MESSAGE" '{message: $message}')
+
+api_call POST "/terminal/${TO}/deliver" "$BODY"
+
+# Create task file in project's .crewly/tasks/ directory
+if [ -n "$PROJECT_PATH" ]; then
+  CREATE_BODY=$(jq -n \
+    --arg projectPath "$PROJECT_PATH" \
+    --arg task "$TASK" \
+    --arg priority "$PRIORITY" \
+    --arg sessionName "$TO" \
+    --arg milestone "delegated" \
+    '{projectPath: $projectPath, task: $task, priority: $priority, sessionName: $sessionName, milestone: $milestone}')
+  api_call POST "/task-management/create" "$CREATE_BODY" || true
+fi

package/config/skills/orchestrator/delegate-task/instructions.md

@@ -0,0 +1,23 @@
+# Delegate Task
+
+Sends a structured task assignment to an agent. When a `projectPath` is provided, also creates a task MD file in the project's `.crewly/tasks/delegated/in_progress/` directory for tracking.
+
+## Usage
+
+```bash
+bash config/skills/orchestrator/delegate-task/execute.sh '{"to":"agent-joe","task":"Implement the login form","priority":"high","context":"Use React hooks","projectPath":"/path/to/project"}'
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `to` | Yes | Target agent's PTY session name |
+| `task` | Yes | Task description |
+| `priority` | No | Task priority: `low`, `normal`, `high` (default: `normal`) |
+| `context` | No | Additional context for the task |
+| `projectPath` | No | Project path; when provided, creates a task MD file in `.crewly/tasks/` |
+
+## Output
+
+JSON confirmation of task delivery. When `projectPath` is provided, also returns the created task file path.