crewly 1.20.29 → 1.20.31

package/config/skills/agent/core/sheets-read/execute.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+# =============================================================================
+# sheets-read — Read cells (or the tab list) of a Google Sheet
+#
+# Backed by GET /api/google/sheets/:id/values?range= and GET /api/google/sheets/:id.
+#
+# Usage:
+#   bash execute.sh --id <spreadsheetId> [--range "Sheet1!A1:D50"]
+#   bash execute.sh --id <spreadsheetId> --info          # title + tabs only
+#   bash execute.sh '{"id":"<spreadsheetId>","range":"A1:D50"}'
+# =============================================================================
+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 --id <spreadsheetId> [--range "Sheet1!A1:D50"]
+  bash execute.sh --id <spreadsheetId> --info          # title + tabs only
+  bash execute.sh '{"id":"<spreadsheetId>","range":"A1:D50"}'
+
+Options:
+  --id          Spreadsheet id (or its URL)
+  --range       A1 range, e.g. "Q3!A1:D50" (default A1:Z1000 on the first tab)
+  --info        Print the title and tab names instead of values
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+ID=""; RANGE=""; INFO=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --id)      [ $# -ge 2 ] || error_exit "--id requires a value";    ID="$2";    shift 2 ;;
+    --range)   [ $# -ge 2 ] || error_exit "--range requires a value"; RANGE="$2"; shift 2 ;;
+    --info)    INFO=1; shift ;;
+    --help|-h) print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$ID" ]    && ID=$(printf '%s' "$INPUT" | jq -r '.id // .spreadsheetId // empty')
+  [ -z "$RANGE" ] && RANGE=$(printf '%s' "$INPUT" | jq -r '.range // empty')
+  [ -z "$INFO" ]  && INFO=$(printf '%s' "$INPUT" | jq -r 'if .info == true then "1" else "" end')
+fi
+ID=$(printf '%s' "$ID" | sed -E 's#.*/spreadsheets/d/([^/?]+).*#\1#')
+require_param "id (--id)" "$ID"
+if [ -n "$INFO" ]; then
+  RESPONSE=$(call GET "/google/sheets/$(uri "$ID")") || { printf '%s\n' "$RESPONSE"; exit 1; }
+  printf '%s' "$RESPONSE" | jq -c '.data'
+  exit 0
+fi
+QS=""; [ -n "$RANGE" ] && QS="?range=$(uri "$RANGE")"
+RESPONSE=$(call GET "/google/sheets/$(uri "$ID")/values${QS}") || { printf '%s\n' "$RESPONSE"; exit 1; }
+if printf '%s' "$RESPONSE" | jq -e '.truncated == true' >/dev/null 2>&1; then printf '%s\n' "$RESPONSE"; exit 0; fi
+printf '%s' "$RESPONSE" | jq -c '{spreadsheetId: .data.spreadsheetId, range: .data.range, rowCount: (.data.rows | length), rows: .data.rows}'

package/config/skills/agent/core/sheets-read/execute.test.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# Tests for sheets-read — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18815
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'spreadsheetId': 's1', 'range': 'Q3!A1:B2', 'rows': [['a', 1]], 'id': 's1', 'title': 'Budget', 'sheets': [{'title': 'Q3'}]}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --id s1 --range "Q3!A1:B2")
+check "values: output" "$OUT" '{"spreadsheetId":"s1","range":"Q3!A1:B2","rowCount":1,"rows":[["a",1]]}'
+check "values: path" "$(jq -r .path "$STUB_LOG")" "/api/google/sheets/s1/values?range=Q3%21A1%3AB2"
+run --id "https://docs.google.com/spreadsheets/d/xyz/edit#gid=0" >/dev/null
+check "url: default range" "$(jq -r .path "$STUB_LOG")" "/api/google/sheets/xyz/values"
+run '{"id":"s1","info":true}' >/dev/null
+check "info: path" "$(jq -r .path "$STUB_LOG")" "/api/google/sheets/s1"
+
+echo "sheets-read: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]

package/config/skills/agent/core/sheets-write/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: Sheets Write
+description: Create a Google Sheet with rows, or append / overwrite rows in a spreadsheet Crewly created (via the Google Workspace grant held by Crewly Cloud). Takes JSON rows or a CSV file. Writes as the owner — share the link when done.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - create spreadsheet
+  - write to google sheet
+  - add rows to the sheet
+  - export to sheets
+tags:
+  - google
+  - sheets
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Sheets Write
+
+```bash
+bash execute.sh --title "Leads Sept" --csv-file /tmp/leads.csv --sheet "Raw"
+bash execute.sh --id 1AbC… --rows '[["Bob","bob@x"]]'                      # append below the table at A1
+bash execute.sh --id 1AbC… --rows '[["done"]]' --range "Raw!C2" --mode update
+```
+
+## Output
+
+```json
+{"success":true,"action":"create","id":"1AbC…","title":"Leads Sept","sheets":["Raw"],"webViewLink":"https://docs.google.com/spreadsheets/d/1AbC…/edit"}
+{"success":true,"action":"append","spreadsheetId":"1AbC…","updatedRange":"Raw!A3:B3","updatedRows":1}
+```
+
+Values are entered as if typed (`USER_ENTERED`): `=SUM(A1:A9)` becomes a
+formula, `2026-09-19` a date. Max 5000 rows per call. Writing to a sheet
+the owner made outside Crewly needs the Sheets write scope (`403 google_error`).
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Google Workspace (Settings → Integrations).
+A `403` with `reason: "google_error"` on a write means the file was not
+created by Crewly — the grant only edits files Crewly made (`drive.file`).

package/config/skills/agent/core/sheets-write/execute.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+# =============================================================================
+# sheets-write — Create a Google Sheet, or append/overwrite rows in one Crewly created
+#
+# Backed by POST /api/google/sheets (create) and POST /api/google/sheets/:id/values.
+#
+# Usage:
+#   bash execute.sh --title "Leads" --rows '[["name","email"],["Ann","a@x"]]' [--sheet "Raw"]
+#   bash execute.sh --title "Leads" --csv-file leads.csv
+#   bash execute.sh --id <spreadsheetId> --rows '[["Bob","b@x"]]' [--range "Raw!A1"]            # append
+#   bash execute.sh --id <spreadsheetId> --rows '[["v"]]' --range "Raw!B2" --mode update       # overwrite
+# =============================================================================
+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 --title "Leads" --rows '[["name","email"],["Ann","a@x"]]' [--sheet "Raw"]
+  bash execute.sh --title "Leads" --csv-file leads.csv
+  bash execute.sh --id <spreadsheetId> --rows '[["Bob","b@x"]]' [--range "Raw!A1"]            # append
+  bash execute.sh --id <spreadsheetId> --rows '[["v"]]' --range "Raw!B2" --mode update       # overwrite
+
+Options:
+  --title       Create a new spreadsheet with this title
+  --sheet       Name of the first tab when creating (default Sheet1)
+  --id          Write into this spreadsheet instead (must be one Crewly created, or the grant needs the Sheets scope)
+  --rows        JSON array of arrays (strings / numbers / booleans)
+  --csv-file    Rows from a CSV file (simple: comma-separated, quotes stripped)
+  --range       A1 anchor: the table to append to, or the top-left cell to overwrite (default A1)
+  --mode        append (default) | update
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+TITLE=""; SHEET=""; ID=""; ROWS=""; CSV_FILE=""; RANGE=""; MODE=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --title)    [ $# -ge 2 ] || error_exit "--title requires a value";    TITLE="$2";    shift 2 ;;
+    --sheet)    [ $# -ge 2 ] || error_exit "--sheet requires a value";    SHEET="$2";    shift 2 ;;
+    --id)       [ $# -ge 2 ] || error_exit "--id requires a value";       ID="$2";       shift 2 ;;
+    --rows)     [ $# -ge 2 ] || error_exit "--rows requires a value";     ROWS="$2";     shift 2 ;;
+    --csv-file) [ $# -ge 2 ] || error_exit "--csv-file requires a value"; CSV_FILE="$2"; shift 2 ;;
+    --range)    [ $# -ge 2 ] || error_exit "--range requires a value";    RANGE="$2";    shift 2 ;;
+    --mode)     [ $# -ge 2 ] || error_exit "--mode requires a value";     MODE="$2";     shift 2 ;;
+    --help|-h)  print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$TITLE" ] && TITLE=$(printf '%s' "$INPUT" | jq -r '.title // empty')
+  [ -z "$SHEET" ] && SHEET=$(printf '%s' "$INPUT" | jq -r '.sheet // .sheetTitle // empty')
+  [ -z "$ID" ]    && ID=$(printf '%s' "$INPUT" | jq -r '.id // .spreadsheetId // empty')
+  [ -z "$ROWS" ]  && ROWS=$(printf '%s' "$INPUT" | jq -c '.rows // empty')
+  [ -z "$RANGE" ] && RANGE=$(printf '%s' "$INPUT" | jq -r '.range // empty')
+  [ -z "$MODE" ]  && MODE=$(printf '%s' "$INPUT" | jq -r '.mode // empty')
+fi
+if [ -n "$CSV_FILE" ]; then
+  [ -f "$CSV_FILE" ] || error_exit "csv file not found: $CSV_FILE"
+  ROWS=$(python3 -c 'import csv,json,sys; print(json.dumps(list(csv.reader(open(sys.argv[1], newline="")))))' "$CSV_FILE")
+fi
+ID=$(printf '%s' "$ID" | sed -E 's#.*/spreadsheets/d/([^/?]+).*#\1#')
+[ -n "$TITLE" ] || [ -n "$ID" ] || error_exit "either --title (create) or --id (write) is required"
+[ -z "$ROWS" ] || printf '%s' "$ROWS" | jq -e 'type == "array" and all(.[]; type == "array")' >/dev/null 2>&1 || error_exit "--rows must be a JSON array of arrays"
+case "$MODE" in ""|append|update) ;; *) error_exit "--mode must be append or update" ;; esac
+if [ -n "$ID" ]; then
+  require_param "rows (--rows or --csv-file)" "$ROWS"
+  BODY=$(jq -cn --argjson rows "$ROWS" --arg range "$RANGE" --arg mode "${MODE:-append}" \
+    '{rows: $rows, mode: $mode} + (if $range != "" then {range: $range} else {} end)')
+  RESPONSE=$(call POST "/google/sheets/$(uri "$ID")/values" "$BODY") || { printf '%s\n' "$RESPONSE"; exit 1; }
+  printf '%s' "$RESPONSE" | jq -c '{success: (.success // false), action: .data.mode, spreadsheetId: .data.spreadsheetId, updatedRange: .data.updatedRange, updatedRows: .data.updatedRows}'
+else
+  BODY=$(jq -cn --arg title "$TITLE" --arg sheet "$SHEET" --argjson rows "${ROWS:-[]}" \
+    '{title: $title} + (if $sheet != "" then {sheetTitle: $sheet} else {} end) + (if ($rows|length) > 0 then {rows: $rows} else {} end)')
+  RESPONSE=$(call POST "/google/sheets" "$BODY") || { printf '%s\n' "$RESPONSE"; exit 1; }
+  printf '%s' "$RESPONSE" | jq -c '{success: (.success // false), action: "create", id: .data.id, title: .data.title, sheets: [.data.sheets[]?.title], webViewLink: .data.webViewLink}'
+fi

package/config/skills/agent/core/sheets-write/execute.test.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Tests for sheets-write — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18816
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'id': 'n1', 'title': data.get('title', 'T'), 'sheets': [{'title': 'Raw'}], 'webViewLink': 'https://l', 'mode': data.get('mode'), 'spreadsheetId': 's1', 'updatedRange': 'Raw!A3:B3', 'updatedRows': len(data.get('rows', []))}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --title "Leads" --sheet Raw --rows '[["name","email"],["Ann","a@x"]]')
+check "create: output" "$OUT" '{"success":true,"action":"create","id":"n1","title":"Leads","sheets":["Raw"],"webViewLink":"https://l"}'
+check "create: body" "$(jq -c .body "$STUB_LOG")" '{"title":"Leads","sheetTitle":"Raw","rows":[["name","email"],["Ann","a@x"]]}'
+TMP="$(mktemp).csv"; printf 'name,email\n"Bob, Jr",b@x\n' > "$TMP"
+OUT=$(run --id "https://docs.google.com/spreadsheets/d/s1/edit" --csv-file "$TMP")
+check "append: output" "$OUT" '{"success":true,"action":"append","spreadsheetId":"s1","updatedRange":"Raw!A3:B3","updatedRows":2}'
+check "append: body" "$(jq -c .body "$STUB_LOG")" '{"rows":[["name","email"],["Bob, Jr","b@x"]],"mode":"append"}'
+rm -f "$TMP"
+run --id s1 --rows '[["v"]]' --range "Raw!B2" --mode update >/dev/null
+check "update: path+body" "$(jq -r '.path + " " + (.body|tojson)' "$STUB_LOG")" '/api/google/sheets/s1/values {"rows":[["v"]],"mode":"update","range":"Raw!B2"}'
+OUT=$(run_err --id s1 --rows '["not","nested"]' || true)
+check "bad rows rejected" "$(printf '%s' "$OUT" | grep -c 'array of arrays')" "1"
+
+echo "sheets-write: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]

package/config/skills/agent/core/slides-create/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: Slides Create
+description: Create a Google Slides deck in the owner's Drive from an outline — one TITLE_AND_BODY slide per entry with its title and bullet lines (via the Google Workspace grant held by Crewly Cloud). Share the link when done.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - create slides
+  - make a deck
+  - build a presentation
+  - turn this into slides
+tags:
+  - google
+  - slides
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Slides Create
+
+```bash
+bash execute.sh --title "Q3 review" --outline-file /tmp/q3.md
+```
+
+`/tmp/q3.md`:
+```
+# Highlights
+- Revenue +12%
+- Two launches
+# Risks
+- Hiring
+```
+
+## Output
+
+```json
+{"success":true,"id":"1AbC…","title":"Q3 review","slideCount":2,"webViewLink":"https://docs.google.com/presentation/d/1AbC…/edit"}
+```
+
+Layout is the default theme's TITLE_AND_BODY; no images. Max 60 slides.
+For designed decks (brand templates, images, video) use the Canva skills.
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Google Workspace (Settings → Integrations).
+A `403` with `reason: "google_error"` on a write means the file was not
+created by Crewly — the grant only edits files Crewly made (`drive.file`).

package/config/skills/agent/core/slides-create/execute.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+# =============================================================================
+# slides-create — Create a Google Slides deck from an outline (title + bullets per slide)
+#
+# Backed by POST /api/google/slides.
+#
+# Usage:
+#   bash execute.sh --title "Pitch" --slides '[{"title":"Why now","bullets":["Market","Timing"]},{"title":"Plan"}]'
+#   bash execute.sh --title "Pitch" --outline-file deck.md     # "# Slide title" then "- bullet" lines
+#   bash execute.sh '{"title":"Pitch","slides":[{"title":"Why now","bullets":["Market"]}]}'
+# =============================================================================
+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 --title "Pitch" --slides '[{"title":"Why now","bullets":["Market","Timing"]},{"title":"Plan"}]'
+  bash execute.sh --title "Pitch" --outline-file deck.md     # "# Slide title" then "- bullet" lines
+  bash execute.sh '{"title":"Pitch","slides":[{"title":"Why now","bullets":["Market"]}]}'
+
+Options:
+  --title         Deck title (required)
+  --slides        JSON array of {title, bullets[]}
+  --outline-file  Markdown outline: each "# Heading" starts a slide, "-"/"*" lines are its bullets
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+TITLE=""; SLIDES=""; OUTLINE_FILE=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --title)        [ $# -ge 2 ] || error_exit "--title requires a value";        TITLE="$2";        shift 2 ;;
+    --slides)       [ $# -ge 2 ] || error_exit "--slides requires a value";       SLIDES="$2";       shift 2 ;;
+    --outline-file) [ $# -ge 2 ] || error_exit "--outline-file requires a value"; OUTLINE_FILE="$2"; shift 2 ;;
+    --help|-h)      print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$TITLE" ]  && TITLE=$(printf '%s' "$INPUT" | jq -r '.title // empty')
+  [ -z "$SLIDES" ] && SLIDES=$(printf '%s' "$INPUT" | jq -c '.slides // empty')
+fi
+if [ -n "$OUTLINE_FILE" ]; then
+  [ -f "$OUTLINE_FILE" ] || error_exit "outline file not found: $OUTLINE_FILE"
+  SLIDES=$(python3 - "$OUTLINE_FILE" <<'PY'
+import json, re, sys
+slides = []
+for raw in open(sys.argv[1], encoding='utf-8'):
+    line = raw.rstrip('\n')
+    if re.match(r'^#{1,6}\s+', line):
+        slides.append({'title': re.sub(r'^#{1,6}\s+', '', line).strip(), 'bullets': []})
+    elif re.match(r'^\s*[-*]\s+', line) and slides:
+        slides[-1]['bullets'].append(re.sub(r'^\s*[-*]\s+', '', line).strip())
+    elif line.strip() and slides:
+        slides[-1]['bullets'].append(line.strip())
+print(json.dumps(slides, ensure_ascii=False))
+PY
+)
+fi
+require_param "title (--title)" "$TITLE"
+require_param "slides (--slides or --outline-file)" "$SLIDES"
+printf '%s' "$SLIDES" | jq -e 'type == "array" and length > 0 and all(.[]; type == "object")' >/dev/null 2>&1 || error_exit "--slides must be a non-empty JSON array of {title, bullets[]}"
+BODY=$(jq -cn --arg title "$TITLE" --argjson slides "$SLIDES" '{title: $title, slides: $slides}')
+RESPONSE=$(call POST "/google/slides" "$BODY") || { printf '%s\n' "$RESPONSE"; exit 1; }
+printf '%s' "$RESPONSE" | jq -c '{success: (.success // false), id: .data.id, title: .data.title, slideCount: .data.slideCount, webViewLink: .data.webViewLink}'

package/config/skills/agent/core/slides-create/execute.test.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Tests for slides-create — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18818
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'id': 'p9', 'title': data.get('title'), 'slideCount': len(data.get('slides', [])), 'webViewLink': 'https://l'}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --title "Pitch" --slides '[{"title":"Why","bullets":["a"]},{"title":"Plan"}]')
+check "json slides: output" "$OUT" '{"success":true,"id":"p9","title":"Pitch","slideCount":2,"webViewLink":"https://l"}'
+check "json slides: body" "$(jq -c .body "$STUB_LOG")" '{"title":"Pitch","slides":[{"title":"Why","bullets":["a"]},{"title":"Plan"}]}'
+TMP="$(mktemp).md"; printf '# Highlights\n- Revenue +12%%\n* Two launches\n\n## Risks\nHiring is slow\n' > "$TMP"
+run --title "Q3" --outline-file "$TMP" >/dev/null
+check "outline: parsed" "$(jq -c .body.slides "$STUB_LOG")" '[{"title":"Highlights","bullets":["Revenue +12%","Two launches"]},{"title":"Risks","bullets":["Hiring is slow"]}]'
+rm -f "$TMP"
+OUT=$(run_err --title "x" --slides '[]' || true)
+check "empty slides rejected" "$(printf '%s' "$OUT" | grep -c 'non-empty')" "1"
+
+echo "slides-create: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]

package/config/skills/agent/core/slides-read/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: Slides Read
+description: Read a Google Slides presentation as text — every text line per slide plus speaker notes (via the Google Workspace grant held by Crewly Cloud). Accepts an id or URL. Read-only.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - read the slides
+  - open the presentation
+  - what is in the deck
+  - summarize the deck
+tags:
+  - google
+  - slides
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Slides Read
+
+```bash
+bash execute.sh --id 1AbC…
+```
+
+## Output
+
+```json
+{"id":"1AbC…","title":"Pitch","slideCount":2,"webViewLink":"https://…","slides":[{"index":1,"lines":["Why now","Market is moving"],"notes":"say hi"},{"index":2,"lines":["Plan"]}]}
+```
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Google Workspace (Settings → Integrations).
+A `403` with `reason: "google_error"` on a write means the file was not
+created by Crewly — the grant only edits files Crewly made (`drive.file`).