crewly 1.0.7 → 1.0.10

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"

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

@@ -0,0 +1,19 @@
+# Read Task
+
+Read the full details of a task file by its absolute path. Returns the task content, metadata, status, and any subtasks.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+
+## Example
+
+```bash
+bash config/skills/agent/read-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md"}'
+```
+
+## Output
+
+JSON with full task details including description, acceptance criteria, priority, status, and related files.

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

@@ -0,0 +1,20 @@
+{
+  "id": "agent-read-task",
+  "name": "Read Task",
+  "description": "Read the full details of a task file by its absolute path.",
+  "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": ["read task", "view task", "show task", "task details"],
+  "tags": ["task", "read", "details"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/recall/execute.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Retrieve stored memories relevant to a given 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 '{\"agentId\":\"dev-1\",\"context\":\"authentication patterns\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "context" "$CONTEXT"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  context: .context
+} +
+  (if .scope then {scope: .scope} else {} end) +
+  (if .limit then {limit: (.limit | tonumber)} else {} end) +
+  (if .projectPath then {projectPath: .projectPath} else {} end)')
+
+api_call POST "/memory/recall" "$BODY"

package/config/skills/agent/core/recall/instructions.md

@@ -0,0 +1,23 @@
+# Recall
+
+Retrieve stored memories relevant to a given context or query. Use this to look up past decisions, architectural patterns, or findings before starting related work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `context` | Yes | Search context or query describing what you want to recall |
+| `scope` | No | Filter by scope: `"project"`, `"team"`, or `"global"` |
+| `limit` | No | Maximum number of results to return |
+| `projectPath` | No | Filter by project path |
+
+## Example
+
+```bash
+bash config/skills/agent/recall/execute.sh '{"agentId":"dev-1","context":"authentication implementation patterns","scope":"project","limit":5}'
+```
+
+## Output
+
+JSON array of matching memory entries with content, category, scope, and timestamps.

package/config/skills/agent/core/recall/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-recall",
+  "name": "Recall",
+  "description": "Retrieve stored memories relevant to a given context or query.",
+  "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": ["recall", "search memory", "remember what", "look up"],
+  "tags": ["memory", "recall", "search", "context"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/record-learning/execute.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Record a learning or insight for team knowledge sharing
+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\",\"learning\":\"Jest mock resets are needed between tests\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+AGENT_ROLE=$(echo "$INPUT" | jq -r '.agentRole // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+LEARNING=$(echo "$INPUT" | jq -r '.learning // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "agentRole" "$AGENT_ROLE"
+require_param "projectPath" "$PROJECT_PATH"
+require_param "learning" "$LEARNING"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  agentRole: .agentRole,
+  projectPath: .projectPath,
+  learning: .learning
+} +
+  (if .relatedTask then {relatedTask: .relatedTask} else {} end) +
+  (if .relatedFiles then {relatedFiles: .relatedFiles} else {} end)')
+
+api_call POST "/memory/record-learning" "$BODY"

package/config/skills/agent/core/record-learning/instructions.md

@@ -0,0 +1,24 @@
+# Record Learning
+
+Record a learning or insight gained during task execution. These learnings are shared with the team and accumulated over time to improve future work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `agentRole` | Yes | Your role (e.g., `"developer"`, `"qa"`) |
+| `projectPath` | Yes | Absolute path to the project |
+| `learning` | Yes | Description of the learning or insight |
+| `relatedTask` | No | Path or ID of the task that triggered this learning |
+| `relatedFiles` | No | Array of file paths related to the learning |
+
+## Example
+
+```bash
+bash config/skills/agent/record-learning/execute.sh '{"agentId":"dev-1","agentRole":"developer","projectPath":"/projects/app","learning":"Jest mock resets are required between tests when using shared module mocks","relatedTask":"implement-auth-tests","relatedFiles":["src/auth.service.test.ts"]}'
+```
+
+## Output
+
+JSON confirmation that the learning was recorded.

package/config/skills/agent/core/record-learning/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-record-learning",
+  "name": "Record Learning",
+  "description": "Record a learning or insight gained during task execution for team knowledge sharing.",
+  "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": ["record learning", "learned that", "new insight", "knowledge share"],
+  "tags": ["memory", "learning", "knowledge", "insight"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/register-self/execute.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Register an agent with the Crewly backend
+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 '{\"role\":\"developer\",\"sessionName\":\"dev-1\"}'"
+
+ROLE=$(echo "$INPUT" | jq -r '.role // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+require_param "role" "$ROLE"
+require_param "sessionName" "$SESSION_NAME"
+
+# Optional: claudeSessionId for resume support
+CLAUDE_SESSION_ID=$(echo "$INPUT" | jq -r '.claudeSessionId // empty')
+TEAM_MEMBER_ID=$(echo "$INPUT" | jq -r '.teamMemberId // empty')
+
+BODY=$(jq -n \
+  --arg role "$ROLE" \
+  --arg sessionName "$SESSION_NAME" \
+  --arg claudeSessionId "$CLAUDE_SESSION_ID" \
+  --arg teamMemberId "$TEAM_MEMBER_ID" \
+  '{role: $role, sessionName: $sessionName} +
+   (if $claudeSessionId != "" then {claudeSessionId: $claudeSessionId} else {} end) +
+   (if $teamMemberId != "" then {teamMemberId: $teamMemberId} else {} end)')
+
+api_call POST "/teams/members/register" "$BODY"

package/config/skills/agent/core/register-self/instructions.md

@@ -0,0 +1,18 @@
+# Register Self
+
+Register this agent as active with the Crewly backend. This must be the first skill you run on startup.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `role` | Yes | Agent role (e.g., "developer", "qa", "tpm") |
+| `sessionName` | Yes | Your session name (from your identity) |
+| `teamMemberId` | No | Your team member ID |
+| `claudeSessionId` | No | Claude session ID for resume support |
+
+## Example
+
+```bash
+bash config/skills/agent/register-self/execute.sh '{"role":"developer","sessionName":"dev-1"}'
+```

package/config/skills/agent/core/register-self/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-register-self",
+  "name": "Register Self",
+  "description": "Register the agent as active with the Crewly backend. Must be called on startup.",
+  "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": ["register", "check in", "go online"],
+  "tags": ["system", "registration", "startup"],
+  "version": "1.0.0"
+}

package/config/skills/agent/core/remember/execute.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Store a memory entry for future recall
+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\",\"content\":\"The auth module uses JWT\",\"category\":\"architecture\",\"scope\":\"project\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
+CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
+SCOPE=$(echo "$INPUT" | jq -r '.scope // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "content" "$CONTENT"
+require_param "category" "$CATEGORY"
+require_param "scope" "$SCOPE"
+
+# Build body with required and optional fields
+BODY=$(echo "$INPUT" | jq '{
+  agentId: .agentId,
+  content: .content,
+  category: .category,
+  scope: .scope
+} +
+  (if .projectPath then {projectPath: .projectPath} else {} end) +
+  (if .metadata then {metadata: .metadata} else {} end)')
+
+api_call POST "/memory/remember" "$BODY"

package/config/skills/agent/core/remember/instructions.md

@@ -0,0 +1,24 @@
+# Remember
+
+Store a memory entry for future recall. Use this to persist important context, decisions, architectural findings, or patterns you discover during work.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `content` | Yes | The content to remember |
+| `category` | Yes | Memory category (e.g., `"architecture"`, `"decision"`, `"pattern"`, `"bug"`) |
+| `scope` | Yes | Memory scope: `"project"`, `"team"`, or `"global"` |
+| `projectPath` | No | Associated project path |
+| `metadata` | No | Additional metadata object |
+
+## Example
+
+```bash
+bash config/skills/agent/remember/execute.sh '{"agentId":"dev-1","content":"Auth module uses JWT with 24h expiry. Refresh tokens stored in httpOnly cookies.","category":"architecture","scope":"project","projectPath":"/projects/app"}'
+```
+
+## Output
+
+JSON confirmation that the memory entry was stored.