crewly 1.0.8 → 1.0.10

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.

package/config/skills/agent/core/marketplace-search/execute.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# Marketplace Search & Install - search and auto-install skills from the marketplace
+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\":\"search\",\"query\":\"code review\"}'"
+
+ACTION=$(echo "$INPUT" | jq -r '.action // "search"')
+QUERY=$(echo "$INPUT" | jq -r '.query // empty')
+ITEM_ID=$(echo "$INPUT" | jq -r '.id // empty')
+TYPE_FILTER=$(echo "$INPUT" | jq -r '.type // empty')
+CATEGORY_FILTER=$(echo "$INPUT" | jq -r '.category // empty')
+
+case "$ACTION" in
+  search)
+    require_param "query" "$QUERY"
+    ENCODED_QUERY=$(printf '%s' "$QUERY" | jq -sRr @uri)
+    ENDPOINT="/marketplace?search=${ENCODED_QUERY}"
+    [ -n "$TYPE_FILTER" ] && ENDPOINT="${ENDPOINT}&type=${TYPE_FILTER}"
+    [ -n "$CATEGORY_FILTER" ] && ENDPOINT="${ENDPOINT}&category=${CATEGORY_FILTER}"
+    RESULT=$(api_call GET "$ENDPOINT")
+    echo "$RESULT"
+    ;;
+
+  install)
+    require_param "id" "$ITEM_ID"
+    RESULT=$(api_call POST "/marketplace/${ITEM_ID}/install")
+    echo "$RESULT"
+    ;;
+
+  search-and-install)
+    require_param "query" "$QUERY"
+    ENCODED_QUERY=$(printf '%s' "$QUERY" | jq -sRr @uri)
+    ENDPOINT="/marketplace?search=${ENCODED_QUERY}"
+    [ -n "$TYPE_FILTER" ] && ENDPOINT="${ENDPOINT}&type=skill"
+    SEARCH_RESULT=$(api_call GET "$ENDPOINT")
+
+    # Parse the first not_installed match
+    MATCH=$(echo "$SEARCH_RESULT" | jq -r '
+      [.[] | select(.installStatus == "not_installed")] | first // empty
+    ')
+
+    if [ -z "$MATCH" ] || [ "$MATCH" = "null" ]; then
+      # Check if any are already installed
+      INSTALLED=$(echo "$SEARCH_RESULT" | jq -r '
+        [.[] | select(.installStatus == "installed")] | first // empty
+      ')
+      if [ -n "$INSTALLED" ] && [ "$INSTALLED" != "null" ]; then
+        INSTALLED_NAME=$(echo "$INSTALLED" | jq -r '.name')
+        echo "{\"success\":true,\"message\":\"Skill already installed: ${INSTALLED_NAME}\",\"action\":\"none\",\"item\":${INSTALLED}}"
+      else
+        echo "{\"success\":false,\"message\":\"No matching skills found for: ${QUERY}\",\"action\":\"none\",\"results\":${SEARCH_RESULT}}"
+      fi
+    else
+      MATCH_ID=$(echo "$MATCH" | jq -r '.id')
+      MATCH_NAME=$(echo "$MATCH" | jq -r '.name')
+      INSTALL_RESULT=$(api_call POST "/marketplace/${MATCH_ID}/install")
+      echo "{\"success\":true,\"message\":\"Installed ${MATCH_NAME}\",\"action\":\"installed\",\"item\":${MATCH},\"installResult\":${INSTALL_RESULT}}"
+    fi
+    ;;
+
+  installed)
+    RESULT=$(api_call GET "/marketplace/installed")
+    echo "$RESULT"
+    ;;
+
+  updates)
+    RESULT=$(api_call GET "/marketplace/updates")
+    echo "$RESULT"
+    ;;
+
+  *)
+    error_exit "Unknown action: ${ACTION}. Use: search, install, search-and-install, installed, updates"
+    ;;
+esac

package/config/skills/agent/core/marketplace-search/instructions.md

@@ -0,0 +1,59 @@
+# Marketplace Search & Install
+
+Search the Crewly marketplace for skills, roles, and models. When you lack a capability needed for a task, use this skill to auto-discover and install it from the marketplace.
+
+## Actions
+
+### `search` — Find items in the marketplace
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"search","query":"code review"}'
+```
+
+Optional filters:
+- `type`: `skill`, `model`, or `role`
+- `category`: `development`, `design`, `communication`, `research`, `content-creation`, `automation`, `analysis`, `integration`, `quality`, `security`
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"search","query":"testing","type":"skill","category":"quality"}'
+```
+
+### `search-and-install` — Find and auto-install the best match
+
+Use this when you need a capability you don't have. It searches for matching skills and installs the first available one automatically.
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"search-and-install","query":"code review"}'
+```
+
+### `install` — Install a specific item by ID
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"install","id":"skill-code-review-pro"}'
+```
+
+### `installed` — List currently installed items
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"installed"}'
+```
+
+### `updates` — Check for available updates
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/marketplace-search/execute.sh '{"action":"updates"}'
+```
+
+## When to Use
+
+- **Before starting a task** that requires a capability you don't have — search for a matching skill
+- **When a task fails** due to missing tools — auto-discover the right skill
+- **Periodically** — check for updates to installed skills
+- **When exploring** what capabilities are available in the ecosystem
+
+## Output
+
+JSON response with search results or install status. Each item includes:
+- `id`, `name`, `description`, `version`, `author`
+- `installStatus`: `not_installed`, `installed`, or `update_available`
+- `category`, `tags`, `rating`, `downloads`

package/config/skills/agent/core/marketplace-search/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "marketplace-search",
+  "name": "Marketplace Search & Install",
+  "description": "Search the Crewly marketplace for skills, roles, and models. Auto-install matching items when the agent lacks a capability.",
+  "category": "automation",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["search marketplace", "find skill", "install skill", "marketplace search", "need capability", "missing skill"],
+  "tags": ["marketplace", "skills", "install", "search", "auto-discover"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/query-knowledge/execute.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Query Knowledge Documents - search company knowledge base
+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 '{\"query\":\"deployment\",\"scope\":\"global\"}'"
+
+QUERY=$(echo "$INPUT" | jq -r '.query // empty')
+SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
+CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+require_param "query" "$QUERY"
+
+# URL-encode the query parameters
+ENCODED_QUERY=$(printf '%s' "$QUERY" | jq -sRr @uri)
+ENDPOINT="/knowledge/documents?scope=${SCOPE}&search=${ENCODED_QUERY}"
+
+if [ -n "$CATEGORY" ]; then
+  ENCODED_CATEGORY=$(printf '%s' "$CATEGORY" | jq -sRr @uri)
+  ENDPOINT="${ENDPOINT}&category=${ENCODED_CATEGORY}"
+fi
+
+if [ -n "$PROJECT_PATH" ]; then
+  ENCODED_PATH=$(printf '%s' "$PROJECT_PATH" | jq -sRr @uri)
+  ENDPOINT="${ENDPOINT}&projectPath=${ENCODED_PATH}"
+fi
+
+api_call GET "$ENDPOINT"

package/config/skills/agent/core/query-knowledge/instructions.md

@@ -0,0 +1,47 @@
+# Query Knowledge
+
+Search the company knowledge base for relevant documents. Use this to find SOPs, runbooks, architecture docs, team norms, and other documentation before starting process-oriented tasks.
+
+Knowledge documents are stored at two scopes:
+- **global** (`~/.crewly/docs/`) — company-wide documents accessible to all agents
+- **project** (`{projectPath}/.crewly/docs/`) — project-specific documents
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `query` | Yes | Search text to match against document titles, tags, and content |
+| `scope` | No | `global` (default) or `project` |
+| `category` | No | Filter by category: `SOPs`, `Team Norms`, `Architecture`, `Onboarding`, `Runbooks`, `General` |
+| `projectPath` | Conditional | Required when scope is `project` |
+
+## Examples
+
+### Search global knowledge for deployment docs
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/query-knowledge/execute.sh '{"query":"deployment","scope":"global"}'
+```
+
+### Search project-specific architecture docs
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/query-knowledge/execute.sh '{"query":"API design","scope":"project","projectPath":"{{PROJECT_PATH}}","category":"Architecture"}'
+```
+
+### Search for runbooks
+
+```bash
+bash {{AGENT_SKILLS_PATH}}/query-knowledge/execute.sh '{"query":"incident response","scope":"global","category":"Runbooks"}'
+```
+
+## When to Use
+
+- **Before process-oriented tasks** — search for SOPs and runbooks that describe how to do things
+- **Before architecture work** — check for existing architecture docs and design decisions
+- **When onboarding to a project** — search for onboarding guides and team norms
+- **Before answering questions** about processes, conventions, or infrastructure
+
+## Output
+
+JSON response with `success: true` and a `data` array of matching document summaries (id, title, category, tags, preview).

package/config/skills/agent/core/query-knowledge/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-query-knowledge",
+  "name": "Query Knowledge",
+  "description": "Search the company knowledge base for SOPs, runbooks, architecture docs, and other documentation.",
+  "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": ["query knowledge", "search knowledge", "find docs", "search docs", "find runbook", "find SOP"],
+  "tags": ["memory", "knowledge", "search", "documentation"],
+  "version": "1.0.0"
+}

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

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Read the full details of a task file by its absolute path
+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\"}'"
+
+ABSOLUTE_TASK_PATH=$(echo "$INPUT" | jq -r '.absoluteTaskPath // empty')
+require_param "absoluteTaskPath" "$ABSOLUTE_TASK_PATH"
+
+BODY=$(jq -n --arg absoluteTaskPath "$ABSOLUTE_TASK_PATH" '{absoluteTaskPath: $absoluteTaskPath}')
+
+api_call POST "/task-management/read-task" "$BODY"