crewly 1.0.1 → 1.0.2

package/config/skills/agent/complete-task/skill.json

@@ -1,20 +0,0 @@
-{
-  "id": "agent-complete-task",
-  "name": "Complete Task",
-  "description": "Mark a task as complete with a summary of the work done.",
-  "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": ["complete task", "finish task", "mark done", "task done"],
-  "tags": ["task", "completion", "status"],
-  "version": "1.0.0"
-}

package/config/skills/agent/computer-use/execute.sh

@@ -1,151 +0,0 @@
-#!/bin/bash
-# =============================================================================
-# Desktop Automation (Computer Use) Skill
-# Controls macOS desktop: screenshots, mouse, keyboard
-# Uses native macOS APIs — no external dependencies required
-# =============================================================================
-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 '{\"action\":\"screenshot|move|click|type\", ...}'"
-
-ACTION=$(echo "$INPUT" | jq -r '.action // empty')
-require_param "action" "$ACTION"
-
-# -----------------------------------------------------------------------------
-# screenshot — capture the screen to a file
-# -----------------------------------------------------------------------------
-do_screenshot() {
-  local output
-  output=$(echo "$INPUT" | jq -r '.output // "/tmp/screenshot.png"')
-
-  # Ensure output directory exists
-  mkdir -p "$(dirname "$output")"
-
-  screencapture -x "$output" 2>/dev/null
-
-  if [ -f "$output" ]; then
-    local size
-    size=$(stat -f%z "$output" 2>/dev/null || stat -c%s "$output" 2>/dev/null || echo "unknown")
-    echo "{\"success\":true,\"action\":\"screenshot\",\"file\":\"$output\",\"size\":$size}"
-  else
-    error_exit "Screenshot failed — file not created"
-  fi
-}
-
-# -----------------------------------------------------------------------------
-# move — move mouse cursor to (x, y)
-# -----------------------------------------------------------------------------
-do_move() {
-  local x y
-  x=$(echo "$INPUT" | jq -r '.x // empty')
-  y=$(echo "$INPUT" | jq -r '.y // empty')
-  require_param "x" "$x"
-  require_param "y" "$y"
-
-  osascript -l JavaScript -e "
-    ObjC.import('CoreGraphics');
-    var point = $.CGPointMake($x, $y);
-    var event = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
-    $.CGEventPost($.kCGHIDEventTap, event);
-    'moved';
-  " >/dev/null 2>&1
-
-  echo "{\"success\":true,\"action\":\"move\",\"x\":$x,\"y\":$y}"
-}
-
-# -----------------------------------------------------------------------------
-# click — click at (x, y) with optional button type
-# -----------------------------------------------------------------------------
-do_click() {
-  local x y button
-  x=$(echo "$INPUT" | jq -r '.x // empty')
-  y=$(echo "$INPUT" | jq -r '.y // empty')
-  button=$(echo "$INPUT" | jq -r '.button // "left"')
-  require_param "x" "$x"
-  require_param "y" "$y"
-
-  case "$button" in
-    left)
-      osascript -l JavaScript -e "
-        ObjC.import('CoreGraphics');
-        var point = $.CGPointMake($x, $y);
-        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
-        $.CGEventPost($.kCGHIDEventTap, move);
-        var down = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
-        $.CGEventPost($.kCGHIDEventTap, down);
-        var up = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
-        $.CGEventPost($.kCGHIDEventTap, up);
-        'clicked';
-      " >/dev/null 2>&1
-      ;;
-    right)
-      osascript -l JavaScript -e "
-        ObjC.import('CoreGraphics');
-        var point = $.CGPointMake($x, $y);
-        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
-        $.CGEventPost($.kCGHIDEventTap, move);
-        var down = $.CGEventCreateMouseEvent(null, $.kCGEventRightMouseDown, point, $.kCGMouseButtonRight);
-        $.CGEventPost($.kCGHIDEventTap, down);
-        var up = $.CGEventCreateMouseEvent(null, $.kCGEventRightMouseUp, point, $.kCGMouseButtonRight);
-        $.CGEventPost($.kCGHIDEventTap, up);
-        'clicked';
-      " >/dev/null 2>&1
-      ;;
-    double)
-      osascript -l JavaScript -e "
-        ObjC.import('CoreGraphics');
-        var point = $.CGPointMake($x, $y);
-        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
-        $.CGEventPost($.kCGHIDEventTap, move);
-        var down1 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
-        $.CGEventSetIntegerValueField(down1, $.kCGMouseEventClickState, 1);
-        $.CGEventPost($.kCGHIDEventTap, down1);
-        var up1 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
-        $.CGEventSetIntegerValueField(up1, $.kCGMouseEventClickState, 1);
-        $.CGEventPost($.kCGHIDEventTap, up1);
-        delay(0.05);
-        var down2 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
-        $.CGEventSetIntegerValueField(down2, $.kCGMouseEventClickState, 2);
-        $.CGEventPost($.kCGHIDEventTap, down2);
-        var up2 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
-        $.CGEventSetIntegerValueField(up2, $.kCGMouseEventClickState, 2);
-        $.CGEventPost($.kCGHIDEventTap, up2);
-        'double-clicked';
-      " >/dev/null 2>&1
-      ;;
-    *)
-      error_exit "Unknown button type: $button (use left, right, or double)"
-      ;;
-  esac
-
-  echo "{\"success\":true,\"action\":\"click\",\"x\":$x,\"y\":$y,\"button\":\"$button\"}"
-}
-
-# -----------------------------------------------------------------------------
-# type — simulate keyboard input
-# -----------------------------------------------------------------------------
-do_type() {
-  local text
-  text=$(echo "$INPUT" | jq -r '.text // empty')
-  require_param "text" "$text"
-
-  osascript -e "tell application \"System Events\" to keystroke \"$text\"" 2>/dev/null
-
-  local char_count=${#text}
-  echo "{\"success\":true,\"action\":\"type\",\"characters\":$char_count}"
-}
-
-# -----------------------------------------------------------------------------
-# Dispatch
-# -----------------------------------------------------------------------------
-case "$ACTION" in
-  screenshot) do_screenshot ;;
-  move)       do_move ;;
-  click)      do_click ;;
-  type)       do_type ;;
-  *)          error_exit "Unknown action: $ACTION (use screenshot, move, click, or type)" ;;
-esac

package/config/skills/agent/computer-use/instructions.md

@@ -1,60 +0,0 @@
-# Desktop Automation (Computer Use)
-
-Control the macOS desktop by taking screenshots, moving/clicking the mouse, and typing text.
-
-## Actions
-
-### Screenshot
-Capture the screen (or a region) to an image file.
-
-```bash
-bash execute.sh '{"action":"screenshot"}'
-bash execute.sh '{"action":"screenshot","output":"/tmp/my-screenshot.png"}'
-```
-
-### Move Mouse
-Move the mouse cursor to a specific coordinate.
-
-```bash
-bash execute.sh '{"action":"move","x":500,"y":300}'
-```
-
-### Click
-Click at a specific coordinate. Supports left click, right click, and double click.
-
-```bash
-bash execute.sh '{"action":"click","x":500,"y":300}'
-bash execute.sh '{"action":"click","x":500,"y":300,"button":"right"}'
-bash execute.sh '{"action":"click","x":500,"y":300,"button":"double"}'
-```
-
-### Type Text
-Type a string of text using simulated keystrokes.
-
-```bash
-bash execute.sh '{"action":"type","text":"Hello, world!"}'
-```
-
-## Parameters
-
-| Parameter | Required | Default | Description |
-|-----------|----------|---------|-------------|
-| `action`  | Yes      | -       | One of: `screenshot`, `move`, `click`, `type` |
-| `x`       | For move/click | - | X coordinate (pixels from left) |
-| `y`       | For move/click | - | Y coordinate (pixels from top) |
-| `button`  | No       | `left`  | Click button: `left`, `right`, or `double` |
-| `text`    | For type | -       | Text string to type |
-| `output`  | No       | `/tmp/screenshot.png` | Screenshot output file path |
-
-## Requirements
-
-- macOS (uses native `screencapture` and CoreGraphics)
-- Accessibility permissions must be granted to the terminal app (System Settings > Privacy & Security > Accessibility)
-
-## Typical Workflow
-
-1. Take a screenshot to see the current screen state
-2. Identify the coordinates of the target element
-3. Move the mouse and/or click on the target
-4. Optionally type text into a focused field
-5. Take another screenshot to verify the result

package/config/skills/agent/computer-use/skill.json

@@ -1,22 +0,0 @@
-{
-  "id": "computer-use",
-  "name": "Desktop Automation (Computer Use)",
-  "description": "Control the macOS desktop: take screenshots, move/click the mouse, and type text. Uses native macOS APIs (screencapture, CoreGraphics via JXA, System Events) with zero external dependencies.",
-  "category": "automation",
-  "skillType": "claude-skill",
-  "promptFile": "instructions.md",
-  "execution": {
-    "type": "script",
-    "script": {
-      "file": "execute.sh",
-      "interpreter": "bash",
-      "timeoutMs": 30000
-    }
-  },
-  "triggers": ["screenshot", "click", "mouse", "type text", "desktop automation", "computer use"],
-  "tags": ["automation", "desktop", "screenshot", "mouse", "keyboard", "macos"],
-  "assignableRoles": ["generalist", "designer", "qa"],
-  "version": "1.0.0",
-  "createdAt": "2026-02-20T00:00:00.000Z",
-  "updatedAt": "2026-02-20T00:00:00.000Z"
-}

package/config/skills/agent/get-my-context/execute.sh

@@ -1,23 +0,0 @@
-#!/bin/bash
-# Retrieve accumulated context including memories, learnings, and project knowledge
-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\"}'"
-
-AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
-AGENT_ROLE=$(echo "$INPUT" | jq -r '.agentRole // empty')
-PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
-require_param "agentId" "$AGENT_ID"
-require_param "agentRole" "$AGENT_ROLE"
-require_param "projectPath" "$PROJECT_PATH"
-
-BODY=$(jq -n \
-  --arg agentId "$AGENT_ID" \
-  --arg agentRole "$AGENT_ROLE" \
-  --arg projectPath "$PROJECT_PATH" \
-  '{agentId: $agentId, agentRole: $agentRole, projectPath: $projectPath}')
-
-api_call POST "/memory/my-context" "$BODY"

package/config/skills/agent/get-my-context/instructions.md

@@ -1,21 +0,0 @@
-# Get My Context
-
-Retrieve your accumulated context including memories, learnings, and project knowledge. Use this at startup or when beginning a new task to load relevant background information.
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `agentId` | Yes | Your agent ID |
-| `agentRole` | Yes | Your role (e.g., `"developer"`, `"qa"`) |
-| `projectPath` | Yes | Absolute path to the current project |
-
-## Example
-
-```bash
-bash config/skills/agent/get-my-context/execute.sh '{"agentId":"dev-1","agentRole":"developer","projectPath":"/projects/app"}'
-```
-
-## Output
-
-JSON with your accumulated context including past memories, learnings, project-specific knowledge, team SOPs, and relevant history.

package/config/skills/agent/get-my-context/skill.json

@@ -1,20 +0,0 @@
-{
-  "id": "agent-get-my-context",
-  "name": "Get My Context",
-  "description": "Retrieve your accumulated context including memories, learnings, and project knowledge.",
-  "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": ["get context", "my context", "what do I know", "load context"],
-  "tags": ["memory", "context", "knowledge", "startup"],
-  "version": "1.0.0"
-}

package/config/skills/agent/get-sops/execute.sh

@@ -1,24 +0,0 @@
-#!/bin/bash
-# Query standard operating procedures relevant to the current 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 '{\"context\":\"deploying to production\"}'"
-
-CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
-require_param "context" "$CONTEXT"
-
-CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
-ROLE=$(echo "$INPUT" | jq -r '.role // empty')
-
-BODY=$(jq -n \
-  --arg context "$CONTEXT" \
-  --arg category "$CATEGORY" \
-  --arg role "$ROLE" \
-  '{context: $context} +
-   (if $category != "" then {category: $category} else {} end) +
-   (if $role != "" then {role: $role} else {} end)')
-
-api_call POST "/system/sops/query" "$BODY"

package/config/skills/agent/get-sops/instructions.md

@@ -1,21 +0,0 @@
-# Get SOPs
-
-Query standard operating procedures (SOPs) relevant to your current context or task. SOPs contain team-defined guidelines, workflows, and best practices.
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `context` | Yes | Description of what you need SOPs for (e.g., `"deploying to production"`) |
-| `category` | No | Filter by SOP category (e.g., `"deployment"`, `"testing"`, `"code-review"`) |
-| `role` | No | Filter by role relevance (e.g., `"developer"`, `"qa"`) |
-
-## Example
-
-```bash
-bash config/skills/agent/get-sops/execute.sh '{"context":"deploying a new backend service","category":"deployment","role":"developer"}'
-```
-
-## Output
-
-JSON with matching SOPs including their titles, content, and applicability metadata.

package/config/skills/agent/get-sops/skill.json

@@ -1,20 +0,0 @@
-{
-  "id": "agent-get-sops",
-  "name": "Get SOPs",
-  "description": "Query standard operating procedures relevant to your current context or task.",
-  "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": ["get sops", "standard procedures", "how to", "best practices"],
-  "tags": ["system", "sops", "procedures", "guidelines"],
-  "version": "1.0.0"
-}

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

@@ -1,8 +0,0 @@
-#!/bin/bash
-# Get the current status of all teams and their members
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "${SCRIPT_DIR}/../_common/lib.sh"
-
-# No input required for this skill
-api_call GET "/teams"

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

@@ -1,17 +0,0 @@
-# Get Team Status
-
-Get the current status of all teams and their members. Returns team names, member roles, agent statuses, and working statuses.
-
-## Parameters
-
-No parameters required.
-
-## Example
-
-```bash
-bash config/skills/agent/get-team-status/execute.sh '{}'
-```
-
-## Output
-
-JSON with team data including each team's members, their roles, agent status (active/inactive), and current working status (idle/in_progress).

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

@@ -1,20 +0,0 @@
-{
-  "id": "agent-get-team-status",
-  "name": "Get Team Status",
-  "description": "Get the current status of all teams and their members.",
-  "category": "monitoring",
-  "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": ["team status", "who is online", "check team", "team members"],
-  "tags": ["monitoring", "team", "status", "agents"],
-  "version": "1.0.0"
-}

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

@@ -1,22 +0,0 @@
-#!/bin/bash
-# =============================================================================
-# Agent Heartbeat Skill - Lightweight health check and heartbeat update
-#
-# Calls the /health endpoint to update the agent heartbeat via the
-# X-Agent-Session middleware header (set automatically by lib.sh).
-# =============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/../../_common/lib.sh"
-
-# Single API call updates heartbeat via the X-Agent-Session middleware
-health_response=$(api_call GET "/health" 2>/dev/null) || health_response='{"error":"unavailable"}'
-
-cat <<EOF
-{
-  "status": "ok",
-  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-  "session": "${CREWLY_SESSION_NAME:-unknown}",
-  "health": $health_response
-}
-EOF

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

@@ -1,23 +0,0 @@
-# Agent Heartbeat Skill
-
-Perform a lightweight health check to confirm that you are responsive.
-
-## When to Use
-
-Run this skill when the system asks you to perform a heartbeat check. This updates your heartbeat timestamp so the monitoring system knows you are alive and responsive.
-
-## Usage
-
-```bash
-bash config/skills/agent/heartbeat/execute.sh
-```
-
-No parameters required.
-
-## Output
-
-Returns a JSON object with:
-- `status`: "ok" if the health endpoint responded
-- `timestamp`: UTC timestamp of the check
-- `session`: your session name
-- `health`: response from the health endpoint

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

@@ -1,20 +0,0 @@
-{
-  "id": "agent-heartbeat",
-  "name": "Heartbeat",
-  "description": "Perform a lightweight health check to confirm the agent is responsive. Updates the heartbeat timestamp via the API middleware.",
-  "category": "monitoring",
-  "skillType": "claude-skill",
-  "promptFile": "instructions.md",
-  "execution": {
-    "type": "script",
-    "script": {
-      "file": "execute.sh",
-      "interpreter": "bash",
-      "timeoutMs": 15000
-    }
-  },
-  "assignableRoles": ["developer", "qa", "devops", "pm", "tpm"],
-  "triggers": ["heartbeat", "health check"],
-  "tags": ["monitoring", "heartbeat", "health"],
-  "version": "1.0.0"
-}

package/config/skills/agent/manage-knowledge/execute.sh

@@ -1,60 +0,0 @@
-#!/bin/bash
-# Manage Knowledge Documents - create or update company knowledge docs
-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 '{\"action\":\"create\",\"title\":\"...\",\"content\":\"...\",\"category\":\"SOPs\",\"scope\":\"global\"}'"
-
-ACTION=$(echo "$INPUT" | jq -r '.action // empty')
-require_param "action" "$ACTION"
-
-if [ "$ACTION" = "create" ]; then
-  TITLE=$(echo "$INPUT" | jq -r '.title // empty')
-  CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
-  CATEGORY=$(echo "$INPUT" | jq -r '.category // "General"')
-  SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
-  PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
-  TAGS=$(echo "$INPUT" | jq -c '.tags // []')
-  CREATED_BY=$(echo "$INPUT" | jq -r '.createdBy // "agent"')
-
-  require_param "title" "$TITLE"
-  require_param "content" "$CONTENT"
-
-  BODY=$(jq -n \
-    --arg title "$TITLE" \
-    --arg content "$CONTENT" \
-    --arg category "$CATEGORY" \
-    --arg scope "$SCOPE" \
-    --arg projectPath "$PROJECT_PATH" \
-    --argjson tags "$TAGS" \
-    --arg createdBy "$CREATED_BY" \
-    '{title: $title, content: $content, category: $category, scope: $scope, projectPath: $projectPath, tags: $tags, createdBy: $createdBy}')
-
-  api_call POST "/knowledge/documents" "$BODY"
-
-elif [ "$ACTION" = "update" ]; then
-  ID=$(echo "$INPUT" | jq -r '.id // empty')
-  require_param "id" "$ID"
-
-  SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
-  PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
-  UPDATED_BY=$(echo "$INPUT" | jq -r '.updatedBy // "agent"')
-
-  # Build update body with only provided fields
-  BODY=$(echo "$INPUT" | jq '{
-    title: .title,
-    content: .content,
-    category: .category,
-    tags: .tags,
-    scope: (.scope // "global"),
-    projectPath: .projectPath,
-    updatedBy: (.updatedBy // "agent")
-  } | with_entries(select(.value != null and .value != ""))')
-
-  api_call PUT "/knowledge/documents/${ID}" "$BODY"
-
-else
-  error_exit "Invalid action '${ACTION}'. Must be 'create' or 'update'"
-fi

package/config/skills/agent/manage-knowledge/instructions.md

@@ -1,46 +0,0 @@
-# Manage Knowledge
-
-Create or update company knowledge documents. These are markdown files stored in the Crewly knowledge system, accessible to all team members via the UI.
-
-Use this skill to document SOPs, architecture decisions, team norms, onboarding guides, runbooks, and other company knowledge that should be shared across the team.
-
-**Note:** Agents can create and update documents but cannot delete them. Deletion is a user-only action via the UI.
-
-## Parameters
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| `action` | Yes | `create` or `update` |
-| `title` | Yes (create) | Document title |
-| `content` | Yes (create) | Markdown content |
-| `category` | No | Category: `SOPs`, `Team Norms`, `Architecture`, `Onboarding`, `Runbooks`, `General` (default: `General`) |
-| `scope` | No | `global` (company-wide) or `project` (project-specific). Default: `global` |
-| `projectPath` | Conditional | Required when scope is `project` |
-| `tags` | No | Array of tags for search/filtering |
-| `createdBy` | No | Your session name (default: `agent`) |
-| `id` | Yes (update) | Document ID to update |
-| `updatedBy` | No | Your session name for updates (default: `agent`) |
-
-## Examples
-
-### Create a global SOP
-
-```bash
-bash config/skills/agent/manage-knowledge/execute.sh '{"action":"create","title":"PR Review Process","content":"# PR Review Process\n\n1. All PRs require at least one approval\n2. Run tests locally before requesting review\n3. Keep PRs under 400 lines when possible","category":"SOPs","scope":"global","tags":["process","code-review"],"createdBy":"dev-1"}'
-```
-
-### Create a project-specific architecture doc
-
-```bash
-bash config/skills/agent/manage-knowledge/execute.sh '{"action":"create","title":"API Design Patterns","content":"# API Design Patterns\n\nWe use RESTful conventions with Express.js...","category":"Architecture","scope":"project","projectPath":"/path/to/project","tags":["api","backend"],"createdBy":"dev-1"}'
-```
-
-### Update an existing document
-
-```bash
-bash config/skills/agent/manage-knowledge/execute.sh '{"action":"update","id":"abc-123-uuid","content":"# Updated Content\n\nNew information added...","scope":"global","updatedBy":"dev-1"}'
-```
-
-## Output
-
-JSON response with `success: true` and the document ID on creation, or `success: true` on update.