crewly 1.0.8 → 1.0.11

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

@@ -0,0 +1,20 @@
+{
+  "id": "agent-accept-task",
+  "name": "Accept Task",
+  "description": "Accept and take the next available task from the task queue.",
+  "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": ["accept task", "take task", "get next task", "pick up task"],
+  "tags": ["task", "queue", "assignment"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/block-task/execute.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Mark a task as blocked with a reason and optional questions
+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 '{\"absoluteTaskPath\":\"/path/to/task\",\"reason\":\"Missing API credentials\"}'"
+
+ABSOLUTE_TASK_PATH=$(echo "$INPUT" | jq -r '.absoluteTaskPath // empty')
+REASON=$(echo "$INPUT" | jq -r '.reason // empty')
+QUESTIONS=$(echo "$INPUT" | jq -r '.questions // empty')
+URGENCY=$(echo "$INPUT" | jq -r '.urgency // empty')
+require_param "absoluteTaskPath" "$ABSOLUTE_TASK_PATH"
+require_param "reason" "$REASON"
+
+BODY=$(jq -n \
+  --arg absoluteTaskPath "$ABSOLUTE_TASK_PATH" \
+  --arg reason "$REASON" \
+  --arg questions "$QUESTIONS" \
+  --arg urgency "$URGENCY" \
+  '{absoluteTaskPath: $absoluteTaskPath, reason: $reason} +
+   (if $questions != "" then {questions: $questions} else {} end) +
+   (if $urgency != "" then {urgency: $urgency} else {} end)')
+
+api_call POST "/task-management/block" "$BODY"

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

@@ -0,0 +1,22 @@
+# Block Task
+
+Mark a task as blocked with a reason explaining the blocker. Optionally include questions for the orchestrator and an urgency level.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+| `reason` | Yes | Explanation of why the task is blocked |
+| `questions` | No | Specific questions for the orchestrator to resolve the blocker |
+| `urgency` | No | Urgency level: `low`, `medium`, `high`, `critical` |
+
+## Example
+
+```bash
+bash config/skills/agent/block-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/deploy-api.md","reason":"Missing production database credentials","questions":"Where are the DB credentials stored?","urgency":"high"}'
+```
+
+## Output
+
+JSON confirmation that the task has been marked as blocked and the orchestrator has been notified.

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

@@ -0,0 +1,20 @@
+{
+  "id": "agent-block-task",
+  "name": "Block Task",
+  "description": "Mark a task as blocked with a reason and optional questions for the orchestrator.",
+  "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": ["block task", "task blocked", "stuck on task", "need help"],
+  "tags": ["task", "blocker", "status"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/check-quality-gates/execute.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Run quality gate checks against the 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 '{\"projectPath\":\"/path/to/project\"}'"
+
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+GATES=$(echo "$INPUT" | jq -r '.gates // empty')
+SKIP_OPTIONAL=$(echo "$INPUT" | jq -r '.skipOptional // empty')
+
+# Build body with optional fields
+BODY=$(echo "$INPUT" | jq '{} +
+  (if .projectPath then {projectPath: .projectPath} else {} end) +
+  (if .gates then {gates: .gates} else {} end) +
+  (if .skipOptional == true then {skipOptional: true} else {} end)')
+
+api_call POST "/quality-gates/check" "$BODY"

package/config/skills/agent/core/check-quality-gates/instructions.md

@@ -0,0 +1,23 @@
+# Check Quality Gates
+
+Run quality gate checks against the project. This includes build verification, linting, unit tests, and any other configured gates. Use this before completing a task to ensure your changes meet project standards.
+
+Note: This operation may take several minutes depending on the project size and configured gates.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `projectPath` | No | Absolute path to the project directory |
+| `gates` | No | Array of specific gates to run (e.g., `["build", "test", "lint"]`). Runs all if omitted |
+| `skipOptional` | No | Set to `true` to skip optional quality gates |
+
+## Example
+
+```bash
+bash config/skills/agent/check-quality-gates/execute.sh '{"projectPath":"/projects/app","gates":["build","test"]}'
+```
+
+## Output
+
+JSON with results for each quality gate including pass/fail status, duration, and any error details.

package/config/skills/agent/core/check-quality-gates/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-check-quality-gates",
+  "name": "Check Quality Gates",
+  "description": "Run quality gate checks (build, tests, lint) against the project before completing a task.",
+  "category": "quality",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 300000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["check quality", "run gates", "quality gates", "verify build", "run tests"],
+  "tags": ["quality", "testing", "build", "lint", "gates"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/complete-task/execute.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Mark a task as complete with a summary of the work done
+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 '{\"absoluteTaskPath\":\"/path/to/task\",\"sessionName\":\"dev-1\",\"summary\":\"Implemented feature X\",\"output\":{\"key\":\"value\"}}'"
+
+ABSOLUTE_TASK_PATH=$(echo "$INPUT" | jq -r '.absoluteTaskPath // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+SUMMARY=$(echo "$INPUT" | jq -r '.summary // empty')
+SKIP_GATES=$(echo "$INPUT" | jq -r '.skipGates // empty')
+OUTPUT_JSON=$(echo "$INPUT" | jq -c '.output // empty')
+require_param "absoluteTaskPath" "$ABSOLUTE_TASK_PATH"
+require_param "sessionName" "$SESSION_NAME"
+require_param "summary" "$SUMMARY"
+
+BODY=$(jq -n \
+  --arg absoluteTaskPath "$ABSOLUTE_TASK_PATH" \
+  --arg sessionName "$SESSION_NAME" \
+  --arg summary "$SUMMARY" \
+  --arg skipGates "$SKIP_GATES" \
+  --argjson output "${OUTPUT_JSON:-null}" \
+  '{absoluteTaskPath: $absoluteTaskPath, sessionName: $sessionName, summary: $summary} +
+   (if $skipGates == "true" then {skipGates: true} else {} end) +
+   (if $output != null then {output: $output} else {} end)')
+
+api_call POST "/task-management/complete" "$BODY"

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

@@ -0,0 +1,53 @@
+# Complete Task
+
+Mark a task as complete with a summary of the work done. If the task has an output schema, provide structured output that will be validated against the schema. Optionally skip quality gates if they have already been verified separately.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+| `sessionName` | Yes | Your agent session name |
+| `summary` | Yes | Summary of the work completed |
+| `output` | No | Structured output object (required if task has an output schema) |
+| `skipGates` | No | Set to `true` to skip quality gate checks |
+
+## Example
+
+```bash
+bash config/skills/agent/complete-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md","sessionName":"dev-1","summary":"Implemented login form with validation and tests"}'
+```
+
+### With structured output
+
+```bash
+bash config/skills/agent/complete-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md","sessionName":"dev-1","summary":"Implemented login","output":{"summary":"Login form with validation","filesChanged":["src/login.tsx","src/login.test.tsx"],"testsAdded":2}}'
+```
+
+## Output Schema
+
+If the task markdown contains an `## Output Schema` section with a JSON Schema definition, your `output` object must validate against that schema. If validation fails, the response will include the errors and you can retry (up to 2 retries). After max retries, the task will be moved to blocked/.
+
+## Pre-Completion Checklist
+
+Before calling this skill, verify:
+
+1. **All requirements met** — re-read the original task and confirm every requirement is addressed
+2. **Code tested** — if you wrote code, run the relevant tests and confirm they pass
+3. **URLs verified** — if your output includes URLs or links, verify they are valid
+4. **Sources cited** — for research tasks, ensure all factual claims have source references
+5. **Summary accurate** — your summary should reflect what was actually done, not just what was planned
+
+## Output
+
+JSON confirmation of task completion status. If validation fails:
+```json
+{
+  "success": false,
+  "validationFailed": true,
+  "errors": ["error details"],
+  "retryCount": 1,
+  "maxRetries": 2,
+  "message": "Output validation failed. 1 retries remaining."
+}
+```

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

@@ -0,0 +1,20 @@
+{
+  "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.1.0"
+}

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

@@ -0,0 +1,23 @@
+#!/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/core/get-my-context/instructions.md

@@ -0,0 +1,21 @@
+# 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/core/get-my-context/skill.json

@@ -0,0 +1,20 @@
+{
+  "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/core/get-sops/execute.sh

@@ -0,0 +1,24 @@
+#!/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/core/get-sops/instructions.md

@@ -0,0 +1,21 @@
+# 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/core/get-sops/skill.json

@@ -0,0 +1,20 @@
+{
+  "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/core/get-team-status/execute.sh

@@ -0,0 +1,8 @@
+#!/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/core/get-team-status/instructions.md

@@ -0,0 +1,17 @@
+# 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/core/get-team-status/skill.json

@@ -0,0 +1,20 @@
+{
+  "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/core/heartbeat/execute.sh

@@ -0,0 +1,22 @@
+#!/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/core/heartbeat/instructions.md

@@ -0,0 +1,23 @@
+# 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/core/heartbeat/skill.json

@@ -0,0 +1,20 @@
+{
+  "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/core/manage-knowledge/execute.sh

@@ -0,0 +1,60 @@
+#!/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/core/manage-knowledge/instructions.md

@@ -0,0 +1,46 @@
+# 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.