{ "tools": [ { "id": "search_tasks", "name": "search_tasks", "description": "Semantic natural-language search across tasks; results include PR links, comments, assignees, and blockers. Use for open-ended queries like 'tasks about X' when no exact filter applies.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Natural-language task search" }, "limit": { "type": "integer", "description": "Max results (1–10)" }, "projectId": { "type": "string" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "find_task_by_branch", "name": "find_task_by_branch", "description": "Look up the task linked to a git branch by exact branch name. Use to find the task for the current branch or check which task a branch belongs to.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "branchName": { "type": "string", "description": "Exact git branch name" } }, "required": [ "branchName" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_my_active_tasks", "name": "list_my_active_tasks", "description": "List my open tasks (todo and in progress). Use when asked what I'm working on right now, my current workload, or my active tasks.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_my_tasks_by_keyword", "name": "search_my_tasks_by_keyword", "description": "Fuzzy keyword match on my own tasks' titles. Use to search my tasks by keyword or find one of my tasks by a word in its title.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Keyword to fuzzy-match against my task titles" }, "limit": { "type": "integer" } }, "required": [ "keyword" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_tasks_by_status", "name": "list_tasks_by_status", "description": "Filter tasks by workflow status keys, optionally within a project. Use to list all tasks currently sitting in a given status column.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "statusFilter": { "type": "string", "description": "Status key(s) to filter by" }, "projectId": { "type": "string" }, "limit": { "type": "integer" } }, "required": [ "statusFilter" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_tasks_by_tag", "name": "list_tasks_by_tag", "description": "Filter tasks by tag names (all must match). Use to list tasks labeled or tagged with a given tag or tag combination.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string" }, "description": "Tag names, ANDed together" }, "limit": { "type": "integer" } }, "required": [ "tags" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_tasks_by_priority", "name": "list_tasks_by_priority", "description": "Filter tasks by priority level. Use to list urgent, high, medium, or low priority tasks.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "priority": { "type": "string", "enum": [ "low", "medium", "high", "urgent" ] }, "limit": { "type": "integer" } }, "required": [ "priority" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_overdue_tasks", "name": "list_overdue_tasks", "description": "List tasks past their due date. Use to show overdue or late tasks that have missed their deadline.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_blocked_tasks", "name": "list_blocked_tasks", "description": "List tasks with unresolved blockers. Use to see which tasks are blocked, stuck, or waiting on something.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_stale_tasks", "name": "list_stale_tasks", "description": "List tasks with no updates in N days (default 7). Use to find stale, idle, or forgotten tasks that have gone quiet.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "days": { "type": "integer", "description": "Staleness threshold in days (default 7)" }, "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_subtasks", "name": "list_subtasks", "description": "List the child subtasks of a parent task. Use to view a task's subtasks or its children.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "parentTaskId": { "type": "string", "description": "Parent task id" } }, "required": [ "parentTaskId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "count_tasks", "name": "count_tasks", "description": "Count tasks matching status, project, or tag filters without listing them. Use for 'how many tasks' questions.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "statusFilter": { "type": "string" }, "projectId": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_tasks_by_time", "name": "search_tasks_by_time", "description": "Find tasks by date range on the created, completed, due, or updated field. Use for tasks created, completed, or due before/after a date or within a window.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "created", "completed", "due", "updated" ] }, "after": { "type": "string", "description": "ISO date" }, "before": { "type": "string", "description": "ISO date" }, "limit": { "type": "integer" } }, "required": [ "field" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "sort_tasks", "name": "sort_tasks", "description": "Return tasks ordered by priority, due date, created or updated time. Use to rank tasks or list them by soonest due date, newest first, etc.", "category": "read", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "sortBy": { "type": "string", "enum": [ "priority", "dueDate", "createdAt", "updatedAt" ] }, "order": { "type": "string", "enum": [ "asc", "desc" ] }, "limit": { "type": "integer" } }, "required": [ "sortBy" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_tasks_with_comments", "name": "search_tasks_with_comments", "description": "Semantic search scoped to task comments. Use to find tasks by what was said or discussed in their threads.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Semantic query against task comments" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_tasks_recently_updated", "name": "search_tasks_recently_updated", "description": "List tasks modified within a recent time window. Use to see what changed lately or which tasks were touched in the last hours or days.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "within": { "type": "string", "description": "Time window, e.g. '24h', '7d'" }, "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_tasks_by_creator", "name": "search_tasks_by_creator", "description": "Filter tasks by the member who created them (creator ID). Use to list tasks created, filed, or reported by a specific person.", "category": "search", "group": "Task discovery & search", "inputSchema": { "type": "object", "properties": { "creatorId": { "type": "string", "description": "Member id of the creator" }, "limit": { "type": "integer" } }, "required": [ "creatorId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_projects", "name": "search_projects", "description": "Find projects by name or topic; returns lifecycle stage, task counts, knowledge summary. Use to look up a project, list matching projects, or get a project ID.", "category": "search", "group": "Project discovery", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Project name or topic" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "count_projects", "name": "count_projects", "description": "Count projects matching an optional query. Use when asked how many projects exist or for a total of projects on a topic.", "category": "read", "group": "Project discovery", "inputSchema": { "type": "object", "properties": { "query": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_feedback", "name": "search_feedback", "description": "Semantic search over customer feedback. Use when asked to find feedback, complaints, feature requests, or what users are saying about a topic.", "category": "search", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Feedback topic or sentiment" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_feedback_by_tag", "name": "search_feedback_by_tag", "description": "List feedback filtered by tags, with include and exclude tag filters. Use when asked for feedback tagged X or excluding tag Y.", "category": "search", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "includeTags": { "type": "array", "items": { "type": "string" } }, "excludeTags": { "type": "array", "items": { "type": "string" } }, "limit": { "type": "integer" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "count_feedback", "name": "count_feedback", "description": "Count feedback items matching a query or tags. Use when asked how many feedback entries, complaints, or requests exist.", "category": "read", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "query": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_customers", "name": "search_customers", "description": "Search customer profiles by name, company, or attributes. Use when asked to look up a customer or find which customers match a description.", "category": "search", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Customer name or profile attributes" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "find_customer_mentions", "name": "find_customer_mentions", "description": "Find documents and feedback that mention a specific customer. Use when asked where a customer is mentioned, referenced, or discussed.", "category": "search", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "customer": { "type": "string", "description": "Customer name or id" }, "limit": { "type": "integer" } }, "required": [ "customer" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "count_customers", "name": "count_customers", "description": "Count customers matching a query. Use when asked how many customers or clients fit a description.", "category": "read", "group": "Customers & feedback", "inputSchema": { "type": "object", "properties": { "query": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "find_documents", "name": "find_documents", "description": "Search documents and AI-extracted knowledge by topic, type, or source. Use when asked to find a doc, spec, note, or written knowledge on a subject.", "category": "search", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Topic to find documents about" }, "type": { "type": "string", "description": "Document type filter" }, "source": { "type": "string", "description": "Source filter" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_document_content", "name": "get_document_content", "description": "Read the full text of a document by ID, paginated. Use when asked to open, read, or show a document's contents.", "category": "read", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "documentId": { "type": "string", "description": "Document id" }, "page": { "type": "integer" }, "pageSize": { "type": "integer" } }, "required": [ "documentId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "download_document", "name": "download_document", "description": "Get a signed download URL (15-min expiry) for a document's original binary file. Use when asked to download, export, or fetch the original file or PDF.", "category": "read", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "documentId": { "type": "string", "description": "Document id" } }, "required": [ "documentId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_document_chunks", "name": "search_document_chunks", "description": "Semantic search inside document text, optionally scoped to one document. Use when asked to find a passage, quote, or section within docs.", "category": "search", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Semantic query inside document bodies" }, "documentId": { "type": "string" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "search_memory", "name": "search_memory", "description": "Look up the Zep knowledge-graph memory. Use when asked what is remembered or known about a person, entity, or fact from past context.", "category": "read", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Memory / knowledge-graph query" }, "limit": { "type": "integer" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_daily_brief", "name": "get_daily_brief", "description": "Personal cross-project daily summary. Use when asked to show today's brief, the morning digest, or a summary of what's happening across projects.", "category": "read", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "timezone": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "deep_research", "name": "deep_research", "description": "Multi-source AI research across tasks, docs, feedback, and customers (8-25s). Use when asked for deep research, an investigation, or a synthesized answer to a broad question.", "category": "read", "group": "Content search & retrieval", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "Research question to investigate across the workspace" } }, "required": [ "query" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "create_task", "name": "create_task", "description": "Create one new task with optional assignee, tags, priority, due date, subtasks, and a semantic duplicate check (duplicatePolicy block). Use to add a single task or todo item.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "title": { "type": "string", "description": "Task title" }, "description": { "type": "string" }, "projectId": { "type": "string" }, "assigneeId": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "priority": { "type": "string", "enum": [ "low", "medium", "high", "urgent" ] }, "dueDate": { "type": "string", "description": "ISO date" }, "duplicatePolicy": { "type": "string", "enum": [ "allow", "block" ] } }, "required": [ "title" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "create_tasks_batch", "name": "create_tasks_batch", "description": "Create up to 100 tasks on a project in one batch call. Use to add multiple or several tasks at once — e.g. seed a new project with initial tasks or bulk-create a task list.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" }, "tasks": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "priority": { "type": "string" } }, "required": [ "title" ] }, "description": "Up to 100 task objects" }, "duplicatePolicy": { "type": "string", "enum": [ "allow", "block" ] }, "checkDuplicates": { "type": "boolean" }, "overrideReason": { "type": "string" }, "replacementForTaskId": { "type": "string" } }, "required": [ "projectId", "tasks" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "update_task", "name": "update_task", "description": "Update a task: set status, assignee, priority, due date, title, description, project, branch, or archive. Use to mark a task as done, complete, close or reopen it, change its due date, edit its description, or assign it to me or someone else.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id to update" }, "statusKey": { "type": "string" }, "assigneeId": { "type": "string" }, "unassign": { "type": "boolean" }, "priority": { "type": "string", "enum": [ "low", "medium", "high", "urgent" ] }, "dueDate": { "type": "string", "description": "ISO date" }, "title": { "type": "string" }, "description": { "type": "string" }, "projectId": { "type": "string" }, "branchName": { "type": "string" }, "archive": { "type": "boolean" } }, "required": [ "taskId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "add_task_comment", "name": "add_task_comment", "description": "Add a markdown comment to a task; supports @mentions. Use to leave a progress update, post a note, or comment on a task.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id" }, "content": { "type": "string", "description": "Markdown comment body" } }, "required": [ "taskId", "content" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "edit_task_comment", "name": "edit_task_comment", "description": "Edit the text of an existing task comment. Use to fix, amend, or reword a comment you already posted.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "commentId": { "type": "string" }, "content": { "type": "string", "description": "New markdown body" } }, "required": [ "commentId", "content" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "delete_task_comment", "name": "delete_task_comment", "description": "Delete a comment from a task. Use to remove a comment posted by mistake or no longer needed.", "category": "write", "group": "Task writes", "inputSchema": { "type": "object", "properties": { "commentId": { "type": "string" } }, "required": [ "commentId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "link_pr_to_task", "name": "link_pr_to_task", "description": "Link a GitHub pull request to a task; auto-assigns the task if unassigned and posts a PR comment. Use to attach, connect, or link a PR / pull request to its task.", "category": "write", "group": "PR & branch linking", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id" }, "prUrl": { "type": "string", "description": "GitHub PR URL" }, "statusKey": { "type": "string" }, "comment": { "type": "string" } }, "required": [ "taskId", "prUrl" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "register_branch_on_task", "name": "register_branch_on_task", "description": "Record a git branch name on a task for later lookup. Use to register, attach, or associate your current branch with an existing task.", "category": "write", "group": "PR & branch linking", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id" }, "branchName": { "type": "string", "description": "Git branch name to register" } }, "required": [ "taskId", "branchName" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "claim_task_and_branch", "name": "claim_task_and_branch", "description": "Start work on a task in one call: assigns it to me (self), sets in_progress, registers the branch, posts a started comment. Use to claim a task, assign it to yourself and start working on it.", "category": "write", "group": "Compound workflow ops", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id to claim" }, "branchName": { "type": "string", "description": "Git branch name" } }, "required": [ "taskId", "branchName" ] }, "isCompound": true, "isWorkflowSkill": false }, { "id": "complete_task_with_review", "name": "complete_task_with_review", "description": "Complete a task with guardrails: checks acceptance criteria, updates status, posts a completion summary, links the PR. Use to review, sign off, and complete a task by taskId when the work is finished, optionally attaching the PR.", "category": "write", "group": "Compound workflow ops", "inputSchema": { "type": "object", "properties": { "taskId": { "type": "string", "description": "Task id to complete" }, "prUrl": { "type": "string" }, "summary": { "type": "string" } }, "required": [ "taskId" ] }, "isCompound": true, "isWorkflowSkill": false }, { "id": "create_task_for_branch", "name": "create_task_for_branch", "description": "Find-or-create the task for a branch (idempotent): registers the branch and can link a PR. Use to create a task for this branch when none exists yet.", "category": "write", "group": "Compound workflow ops", "inputSchema": { "type": "object", "properties": { "branchName": { "type": "string", "description": "Git branch name" }, "projectId": { "type": "string", "description": "Project to create in" }, "title": { "type": "string", "description": "Task title" }, "description": { "type": "string" }, "prUrl": { "type": "string" }, "source": { "type": "string" } }, "required": [ "branchName", "projectId", "title" ] }, "isCompound": true, "isWorkflowSkill": false }, { "id": "create_document", "name": "create_document", "description": "Create a markdown document from inline content (notes, specs, writeups). Use when asked to write down, save, or draft a doc or note.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "title": { "type": "string" }, "content": { "type": "string", "description": "Markdown body" }, "projectId": { "type": "string" } }, "required": [ "title", "content" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "upload_request_urls", "name": "upload_request_urls", "description": "Generate presigned URLs for uploading local files into Kestral. Use when asked to upload a file, attachment, or binary programmatically.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "contentType": { "type": "string" } }, "required": [ "name" ] } } }, "required": [ "files" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "interactive_upload", "name": "interactive_upload", "description": "Open an interactive file-upload UI (MCP Apps hosts only). Use when the member wants to pick and upload files manually via a dialog.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "prompt": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "resolve_assets", "name": "resolve_assets", "description": "Resolve markdown-asset:// URIs into viewable vision tokens. Use when asked to view or render images or assets embedded in a document.", "category": "read", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "uris": { "type": "array", "items": { "type": "string" }, "description": "markdown-asset:// URIs" } }, "required": [ "uris" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "link_external_document", "name": "link_external_document", "description": "Connect a Notion, Google Drive, or Slack URL as an autosynced external document. Use when asked to import, sync, or watch an external page or link.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "url": { "type": "string", "description": "Notion/Drive/Slack URL" }, "projectId": { "type": "string" } }, "required": [ "url" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "link_document_to_project", "name": "link_document_to_project", "description": "Attach an existing document to a project. Use when asked to put or file a doc under a project.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "documentId": { "type": "string" }, "projectId": { "type": "string" } }, "required": [ "documentId", "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "unlink_document_from_project", "name": "unlink_document_from_project", "description": "Detach a document from a project without deleting it. Use when asked to remove a doc from a project.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "documentId": { "type": "string" }, "projectId": { "type": "string" } }, "required": [ "documentId", "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "update_document", "name": "update_document", "description": "Edit a document's title and/or content by ID. Use when asked to rename a doc, rewrite it, or replace its contents.", "category": "write", "group": "Documents & uploads", "inputSchema": { "type": "object", "properties": { "documentId": { "type": "string" }, "title": { "type": "string" }, "content": { "type": "string" } }, "required": [ "documentId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "create_project", "name": "create_project", "description": "Create a new empty project (title, description, lifecycle status). Use when: set up a new project, kick off a project, spin up a fresh one.", "category": "write", "group": "Project management", "inputSchema": { "type": "object", "properties": { "title": { "type": "string", "description": "Project title" }, "description": { "type": "string" }, "lifecycleStatus": { "type": "string" } }, "required": [ "title" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "trigger_brain_build", "name": "trigger_brain_build", "description": "Regenerate the Project Brain from latest data (~30s). Use when: rebuild or refresh the brain, project knowledge is outdated and needs regeneration.", "category": "write", "group": "Project management", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "manage_project", "name": "manage_project", "description": "Delegate multi-step project management to an agent via a plain-English instruction: retag, restructure hierarchy, bulk edits across a project. Use for reorganizing or cleaning up a whole project.", "category": "write", "group": "Project management", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" }, "instruction": { "type": "string", "description": "Natural-language project-management instruction" } }, "required": [ "instruction" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_project_brain", "name": "get_project_brain", "description": "Read the full Project Brain — everything the AI knows about a project: goals, blockers, next steps, current status. Use for a project overview or to catch up on where a project stands.", "category": "read", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_project_pending_changes", "name": "get_project_pending_changes", "description": "List a project's pending AI proposals — brain, doc, and task suggestions awaiting review. Use to see what changes the AI is suggesting on a project.", "category": "read", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_pending_change_details", "name": "list_pending_change_details", "description": "Get individual changeIds and details for each pending AI suggestion on a project. Use to pick a specific proposal before approving or rejecting it.", "category": "read", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "approve_pending_change", "name": "approve_pending_change", "description": "Accept one pending AI suggestion by changeId and apply it. Use when: approve the proposed change, accept the suggestion, confirm the AI's edit.", "category": "write", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "changeId": { "type": "string" } }, "required": [ "changeId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "reject_pending_change", "name": "reject_pending_change", "description": "Reject one pending AI suggestion by changeId, with an optional reason. Use when: decline, dismiss, or turn down a proposed change.", "category": "write", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "changeId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "changeId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_project_brain_freshness", "name": "get_project_brain_freshness", "description": "Check whether the Project Brain is up to date: generation status and last-updated timestamp. Use when asking if the brain is stale or fresh, or when it was last updated.", "category": "read", "group": "Project Brain transparency", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_daily_planning_context", "name": "get_daily_planning_context", "description": "Raw data bundle for planning your day: daily brief plus active, overdue, and blocked tasks in one call. Use when you need today's context to plan and prioritize what to work on.", "category": "read", "group": "Daily planning & activity", "inputSchema": { "type": "object", "properties": { "timezone": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_daily_closeout_context", "name": "get_daily_closeout_context", "description": "Raw end-of-day closeout data bundle: what got done, not done, unclear, and data gaps for today. Use when you need wrap-up data to review what you finished or did not finish today.", "category": "read", "group": "Daily planning & activity", "inputSchema": { "type": "object", "properties": { "timezone": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": false }, { "id": "get_project_activity_feed", "name": "get_project_activity_feed", "description": "Recent activity feed for one project within a time window. Use when asked what happened on a project lately, recent changes this week, or for a timeline of project events.", "category": "read", "group": "Daily planning & activity", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string" }, "within": { "type": "string", "description": "Time window, e.g. '24h'" } }, "required": [ "projectId" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "check_task_duplicates", "name": "check_task_duplicates", "description": "Standalone duplicate check for a task title — finds similar existing tasks without creating anything. Use when asked is this a duplicate, does this task already exist, or to dedupe before creating.", "category": "read", "group": "Data quality & integrations", "inputSchema": { "type": "object", "properties": { "title": { "type": "string", "description": "Candidate task title" }, "projectId": { "type": "string" } }, "required": [ "title" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "list_integrations", "name": "list_integrations", "description": "List all integrations and their connection status. Use when asked which integrations, apps, or external services are connected.", "category": "read", "group": "Data quality & integrations", "inputSchema": { "type": "object", "properties": {} }, "isCompound": false, "isWorkflowSkill": false }, { "id": "check_integration_status", "name": "check_integration_status", "description": "Connection status for a single integration service, plus import session progress. Use when asked if a specific service is connected or how far along an import or sync is.", "category": "read", "group": "Data quality & integrations", "inputSchema": { "type": "object", "properties": { "service": { "type": "string", "description": "Integration service name, e.g. 'github'" } }, "required": [ "service" ] }, "isCompound": false, "isWorkflowSkill": false }, { "id": "plan_day_workflow", "name": "plan_day_workflow", "description": "Guided morning day-planning workflow: returns skill instructions plus daily brief and active/overdue/blocked tasks. Use when asked to plan my day, prioritize what to work on, or kick off the workday.", "category": "read", "group": "Workflow skill operations", "inputSchema": { "type": "object", "properties": { "timezone": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": true }, { "id": "end_day_review_workflow", "name": "end_day_review_workflow", "description": "Guided end-of-day review workflow: returns skill instructions plus a closeout of what got done vs not done. Use when asked what did I finish today, wrap up my day, or run an evening review.", "category": "read", "group": "Workflow skill operations", "inputSchema": { "type": "object", "properties": { "timezone": { "type": "string" } } }, "isCompound": false, "isWorkflowSkill": true }, { "id": "sync_session_workflow", "name": "sync_session_workflow", "description": "Guided workflow to sync a coding session with Kestral: returns skill instructions plus your active tasks. Use when you begin, resume, or hand off a coding session — sync my session now.", "category": "read", "group": "Workflow skill operations", "inputSchema": { "type": "object", "properties": { "intent": { "type": "string", "enum": [ "update", "create", "pickup", "update_or_create", "session_start" ], "description": "Sync intent (default 'update')" } } }, "isCompound": false, "isWorkflowSkill": true }, { "id": "setup_workflow", "name": "setup_workflow", "description": "Guided onboarding workflow: returns skill instructions plus your projects and daily brief. Use when getting started with Kestral, onboarding into a workspace, or running first-time workspace setup.", "category": "read", "group": "Workflow skill operations", "inputSchema": { "type": "object", "properties": {} }, "isCompound": false, "isWorkflowSkill": true }, { "id": "send_notification", "name": "send_notification", "description": "Send a notification to a teammate or channel with a title and body. Use to alert someone about an event or ping a channel.", "category": "notify", "group": "Notifications & alerts", "inputSchema": { "type": "object", "properties": { "recipient": { "type": "string", "description": "User id or channel" }, "title": { "type": "string", "description": "Notification title" }, "body": { "type": "string", "description": "Notification body" } }, "required": [ "recipient", "title" ] }, "isWorkflowSkill": false }, { "id": "list_notifications", "name": "list_notifications", "description": "List the current user's notifications, newest first, optionally filtered to unread only. Use to see what has pinged you.", "category": "notify", "group": "Notifications & alerts", "inputSchema": { "type": "object", "properties": { "unreadOnly": { "type": "boolean", "description": "Only unread" }, "limit": { "type": "integer", "description": "Max results" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "mark_notification_read", "name": "mark_notification_read", "description": "Mark one notification as read by its id so it stops showing as unread.", "category": "notify", "group": "Notifications & alerts", "inputSchema": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Notification id" } }, "required": [ "notificationId" ] }, "isWorkflowSkill": false }, { "id": "mute_notification_channel", "name": "mute_notification_channel", "description": "Mute a notification channel for a period so it stops delivering alerts. Use to silence noisy channels.", "category": "notify", "group": "Notifications & alerts", "inputSchema": { "type": "object", "properties": { "channelId": { "type": "string", "description": "Channel id" }, "hours": { "type": "integer", "description": "Mute duration in hours" } }, "required": [ "channelId" ] }, "isWorkflowSkill": false }, { "id": "configure_alert_rule", "name": "configure_alert_rule", "description": "Create or update an alert rule that fires a notification when a metric crosses a threshold.", "category": "notify", "group": "Notifications & alerts", "inputSchema": { "type": "object", "properties": { "metric": { "type": "string", "description": "Metric name" }, "threshold": { "type": "integer", "description": "Threshold value" }, "channelId": { "type": "string", "description": "Channel to alert" } }, "required": [ "metric", "threshold" ] }, "isWorkflowSkill": false }, { "id": "schedule_meeting", "name": "schedule_meeting", "description": "Schedule a calendar meeting with attendees, a title, a start time, and a duration. Use to book a call.", "category": "calendar", "group": "Calendar & meetings", "inputSchema": { "type": "object", "properties": { "title": { "type": "string", "description": "Meeting title" }, "startTime": { "type": "string", "description": "ISO start time" }, "durationMinutes": { "type": "integer", "description": "Duration" }, "attendees": { "type": "array", "items": { "type": "string" }, "description": "Attendee ids" } }, "required": [ "title", "startTime" ] }, "isWorkflowSkill": false }, { "id": "list_calendar_events", "name": "list_calendar_events", "description": "List calendar events in a date range for the current user. Use to see the day's or week's schedule.", "category": "calendar", "group": "Calendar & meetings", "inputSchema": { "type": "object", "properties": { "from": { "type": "string", "description": "ISO start date" }, "to": { "type": "string", "description": "ISO end date" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "cancel_meeting", "name": "cancel_meeting", "description": "Cancel a scheduled meeting by its event id and notify attendees.", "category": "calendar", "group": "Calendar & meetings", "inputSchema": { "type": "object", "properties": { "eventId": { "type": "string", "description": "Calendar event id" } }, "required": [ "eventId" ] }, "isWorkflowSkill": false }, { "id": "find_free_time_slots", "name": "find_free_time_slots", "description": "Find open time slots on the calendar for a set of attendees within a window, for booking a meeting.", "category": "calendar", "group": "Calendar & meetings", "inputSchema": { "type": "object", "properties": { "attendees": { "type": "array", "items": { "type": "string" }, "description": "Attendee ids" }, "durationMinutes": { "type": "integer", "description": "Needed duration" }, "window": { "type": "string", "description": "Search window" } }, "required": [ "attendees", "durationMinutes" ] }, "isWorkflowSkill": false }, { "id": "set_calendar_reminder", "name": "set_calendar_reminder", "description": "Set a personal calendar reminder at a specific time with a message. Use for standalone reminders, not tasks.", "category": "calendar", "group": "Calendar & meetings", "inputSchema": { "type": "object", "properties": { "remindAt": { "type": "string", "description": "ISO time" }, "message": { "type": "string", "description": "Reminder text" } }, "required": [ "remindAt", "message" ] }, "isWorkflowSkill": false }, { "id": "get_pull_request_status", "name": "get_pull_request_status", "description": "Get the review and merge status of a GitHub pull request by number, including checks and approvals.", "category": "github", "group": "GitHub & CI", "inputSchema": { "type": "object", "properties": { "repo": { "type": "string", "description": "owner/name" }, "number": { "type": "integer", "description": "PR number" } }, "required": [ "repo", "number" ] }, "isWorkflowSkill": false }, { "id": "list_open_pull_requests", "name": "list_open_pull_requests", "description": "List open pull requests in a repository, optionally filtered by author or label.", "category": "github", "group": "GitHub & CI", "inputSchema": { "type": "object", "properties": { "repo": { "type": "string", "description": "owner/name" }, "author": { "type": "string", "description": "Filter by author" }, "label": { "type": "string", "description": "Filter by label" } }, "required": [ "repo" ] }, "isWorkflowSkill": false }, { "id": "get_ci_build_status", "name": "get_ci_build_status", "description": "Get the status of the latest CI build for a branch or commit, including which jobs failed.", "category": "github", "group": "GitHub & CI", "inputSchema": { "type": "object", "properties": { "repo": { "type": "string", "description": "owner/name" }, "ref": { "type": "string", "description": "Branch or commit sha" } }, "required": [ "repo", "ref" ] }, "isWorkflowSkill": false }, { "id": "rerun_ci_pipeline", "name": "rerun_ci_pipeline", "description": "Re-run a CI pipeline for a given run id, optionally only the failed jobs.", "category": "github", "group": "GitHub & CI", "inputSchema": { "type": "object", "properties": { "runId": { "type": "string", "description": "CI run id" }, "failedOnly": { "type": "boolean", "description": "Only failed jobs" } }, "required": [ "runId" ] }, "isWorkflowSkill": false }, { "id": "list_repository_branches", "name": "list_repository_branches", "description": "List branches in a Git repository, optionally filtered by a name prefix.", "category": "github", "group": "GitHub & CI", "inputSchema": { "type": "object", "properties": { "repo": { "type": "string", "description": "owner/name" }, "prefix": { "type": "string", "description": "Name prefix" } }, "required": [ "repo" ] }, "isWorkflowSkill": false }, { "id": "get_velocity_metrics", "name": "get_velocity_metrics", "description": "Compute team velocity (completed points per sprint) over recent sprints for reporting.", "category": "analytics", "group": "Analytics & reporting", "inputSchema": { "type": "object", "properties": { "sprints": { "type": "integer", "description": "Number of recent sprints" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "generate_burndown_chart", "name": "generate_burndown_chart", "description": "Generate a burndown chart for a sprint, returning a chart image url and the remaining-work series.", "category": "analytics", "group": "Analytics & reporting", "inputSchema": { "type": "object", "properties": { "sprintId": { "type": "string", "description": "Sprint id" } }, "required": [ "sprintId" ] }, "isWorkflowSkill": false }, { "id": "get_cycle_time_stats", "name": "get_cycle_time_stats", "description": "Return cycle-time statistics (median, p90) for completed work items in a date range.", "category": "analytics", "group": "Analytics & reporting", "inputSchema": { "type": "object", "properties": { "from": { "type": "string", "description": "ISO start" }, "to": { "type": "string", "description": "ISO end" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "export_report_csv", "name": "export_report_csv", "description": "Export a report of the given type to a downloadable CSV file for a date range.", "category": "analytics", "group": "Analytics & reporting", "inputSchema": { "type": "object", "properties": { "reportType": { "type": "string", "description": "Report type" }, "from": { "type": "string", "description": "ISO start" }, "to": { "type": "string", "description": "ISO end" } }, "required": [ "reportType" ] }, "isWorkflowSkill": false }, { "id": "get_throughput_summary", "name": "get_throughput_summary", "description": "Summarize throughput (items completed per week) for a team over a period.", "category": "analytics", "group": "Analytics & reporting", "inputSchema": { "type": "object", "properties": { "teamId": { "type": "string", "description": "Team id" }, "weeks": { "type": "integer", "description": "Weeks to include" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "list_team_members", "name": "list_team_members", "description": "List members of a team with their roles. Use to see who is on a team.", "category": "team", "group": "Team & members", "inputSchema": { "type": "object", "properties": { "teamId": { "type": "string", "description": "Team id" } }, "required": [ "teamId" ] }, "isWorkflowSkill": false }, { "id": "get_member_availability", "name": "get_member_availability", "description": "Get a member's availability and current capacity for scheduling or load balancing.", "category": "team", "group": "Team & members", "inputSchema": { "type": "object", "properties": { "memberId": { "type": "string", "description": "Member id" } }, "required": [ "memberId" ] }, "isWorkflowSkill": false }, { "id": "invite_member", "name": "invite_member", "description": "Invite a person to the workspace by email with an initial role.", "category": "team", "group": "Team & members", "inputSchema": { "type": "object", "properties": { "email": { "type": "string", "description": "Invitee email" }, "role": { "type": "string", "description": "Initial role" } }, "required": [ "email" ] }, "isWorkflowSkill": false }, { "id": "get_workload_distribution", "name": "get_workload_distribution", "description": "Return how open work is distributed across team members to spot overload.", "category": "team", "group": "Team & members", "inputSchema": { "type": "object", "properties": { "teamId": { "type": "string", "description": "Team id" } }, "required": [ "teamId" ] }, "isWorkflowSkill": false }, { "id": "set_member_role", "name": "set_member_role", "description": "Change a workspace member's role (admin, member, viewer).", "category": "team", "group": "Team & members", "inputSchema": { "type": "object", "properties": { "memberId": { "type": "string", "description": "Member id" }, "role": { "type": "string", "description": "New role" } }, "required": [ "memberId", "role" ] }, "isWorkflowSkill": false }, { "id": "create_sprint", "name": "create_sprint", "description": "Create a new sprint with a name and start/end dates for planning work.", "category": "sprint", "group": "Sprints, labels & milestones", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "description": "Sprint name" }, "startDate": { "type": "string", "description": "ISO start" }, "endDate": { "type": "string", "description": "ISO end" } }, "required": [ "name" ] }, "isWorkflowSkill": false }, { "id": "list_sprints", "name": "list_sprints", "description": "List sprints for a project, optionally only the active one.", "category": "sprint", "group": "Sprints, labels & milestones", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "description": "Project id" }, "activeOnly": { "type": "boolean", "description": "Only active" } }, "required": [] }, "isWorkflowSkill": false }, { "id": "create_label", "name": "create_label", "description": "Create a colored label that can be attached to items for categorization.", "category": "sprint", "group": "Sprints, labels & milestones", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "description": "Label name" }, "color": { "type": "string", "description": "Hex color" } }, "required": [ "name" ] }, "isWorkflowSkill": false }, { "id": "create_milestone", "name": "create_milestone", "description": "Create a project milestone with a title and a due date to group deliverables.", "category": "sprint", "group": "Sprints, labels & milestones", "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "description": "Project id" }, "title": { "type": "string", "description": "Milestone title" }, "dueDate": { "type": "string", "description": "ISO due date" } }, "required": [ "title" ] }, "isWorkflowSkill": false }, { "id": "get_sprint_summary", "name": "get_sprint_summary", "description": "Get a summary of a sprint: scope, completed points, and carryover.", "category": "sprint", "group": "Sprints, labels & milestones", "inputSchema": { "type": "object", "properties": { "sprintId": { "type": "string", "description": "Sprint id" } }, "required": [ "sprintId" ] }, "isWorkflowSkill": false } ], "gold": [ { "query": "create a task for this branch", "expectTop5": [ "create_task_for_branch" ], "preferOver": [], "source": "kestral-live" }, { "query": "find a task by its linked branch name", "expectTop5": [ "find_task_by_branch" ], "preferOver": [], "source": "kestral-live" }, { "query": "set up a new project and add three initial tasks to it", "expectTop5": [ "create_project", "create_tasks_batch" ], "preferOver": [], "source": "kestral-live" }, { "query": "plan my day and prioritize what to work on", "expectTop5": [ "plan_day_workflow", "get_daily_planning_context" ], "preferOver": [], "source": "kestral-live" }, { "query": "mark a task as done", "expectTop5": [ "update_task" ], "preferOver": [], "source": "kestral-live" }, { "query": "leave a progress update comment on the task for my current branch", "expectTop5": [ "add_task_comment", "find_task_by_branch" ], "preferOver": [], "source": "kestral-live" }, { "query": "link this pull request to its task", "expectTop5": [ "link_pr_to_task" ], "preferOver": [], "source": "kestral-live" }, { "query": "complete the task for my branch", "expectTop5": [ "update_task", "complete_task_with_review", "find_task_by_branch" ], "preferOver": [], "source": "kestral-live" }, { "query": "search my tasks by keyword", "expectTop5": [ "search_my_tasks_by_keyword" ], "preferOver": [], "source": "kestral-live" }, { "query": "what am I working on right now", "expectTop5": [ "list_my_active_tasks" ], "preferOver": [], "source": "kestral-live" }, { "query": "end of day review, what did I finish today", "expectTop5": [ "end_day_review_workflow", "get_daily_closeout_context" ], "preferOver": [], "source": "kestral-live" }, { "query": "assign this task to me and start working on it", "expectTop5": [ "claim_task_and_branch", "update_task" ], "preferOver": [], "source": "kestral-live" }, { "query": "change the due date of a task", "expectTop5": [ "update_task" ], "preferOver": [], "source": "kestral-live" }, { "query": "show overdue tasks", "expectTop5": [ "list_overdue_tasks" ], "preferOver": [], "source": "kestral-live" } ], "skills": [ { "id": "plan-day", "name": "plan-day", "description": "Build a morning operating plan: pull the daily brief, list active/overdue/blocked tasks, and prioritize what to work on today.", "tags": [ "planning", "prioritize", "morning", "daily", "standup", "what to work on" ], "tools": [ "inapp__dailyBriefQuery", "inapp__taskQuery" ], "body": "# Plan Day\n\nGoal: turn the workspace state into one short, ordered plan for today.\n\n## 1. Gather (independent — call together)\n- `inapp__dailyBriefQuery` — today's priorities, overdue count, blockers.\n- `inapp__taskQuery` — my active and in_progress tasks.\n\n## 2. Prioritize\nRank by: overdue first, then blocked-that-I-can-unblock, then high priority, then in-progress. Keep it to the top 3–5.\n\n## 3. Present\nReturn a numbered plan with one line each: what, why now, first concrete step. This is read-only — do not modify tasks." }, { "id": "end-day-review", "name": "end-day-review", "description": "Run an end-of-day review: what got done, what didn't, what's unclear, and what to carry into tomorrow.", "tags": [ "closeout", "review", "end of day", "retro", "wrap up", "summary" ], "tools": [ "inapp__taskQuery", "inapp__dailyBriefQuery" ], "body": "# End Day Review\n\nGoal: a crisp closeout — Done / Not Done / Unclear / carry-over.\n\n## 1. Gather\n- `inapp__taskQuery` — tasks touched today (status changes, comments).\n- `inapp__dailyBriefQuery` — what today's plan intended.\n\n## 2. Bucket\nSort into **Done**, **Not Done**, **Unclear** (needs a decision), and flag any data gaps.\n\n## 3. Present\nSummarize each bucket in one line and propose tomorrow's top 3. Read-only — do not modify tasks." }, { "id": "sync-session", "name": "sync-session", "description": "Sync a coding session to Kestral: find the task for the current branch, summarize progress, and prepare a status update or new task.", "tags": [ "sync", "coding session", "branch", "progress update", "pickup", "post push" ], "tools": [ "inapp__taskQuery", "inapp__codeAgent", "inapp__entityLookup" ], "body": "# Sync Session\n\nGoal: reconcile what changed in the repo with the task tracking Kestral.\n\n## 1. Locate\n- `inapp__taskQuery` — find the task linked to the current branch.\n- `inapp__codeAgent` — summarize the branch's commits/diff since the last sync.\n\n## 2. Reconcile\nMatch code changes to the task's intent. If no task exists for the branch, propose creating one; otherwise draft a progress comment.\n\n## 3. Present\nReturn the proposed status update or new-task draft for confirmation before any write." }, { "id": "research-customer", "name": "research-customer", "description": "Assemble a customer briefing: profile, recent feedback and sentiment, related documents, and remembered context across the workspace.", "tags": [ "customer", "account research", "briefing", "feedback", "sentiment", "prep" ], "tools": [ "inapp__customerSearch", "inapp__feedbackQuery", "inapp__contextKnowledgeQuery", "inapp__memoryQuery" ], "body": "# Research Customer\n\nGoal: everything known about a customer, in one brief. Read-only.\n\n## 1. Build the picture (independent — call together)\n- `inapp__customerSearch` — profile, tier, ARR, open items.\n- `inapp__feedbackQuery` — recent feedback + sentiment.\n- `inapp__contextKnowledgeQuery` — extracted decisions/blockers tied to this account.\n- `inapp__memoryQuery` — anything remembered across prior sessions.\n\n## 2. Synthesize\nWrite 3–5 bullets: who they are, what they're asking for, current sentiment, risks/opportunities.\n\n## 3. Close\nEnd with the single most useful next action for this account." }, { "id": "deep-research-brief", "name": "deep-research-brief", "description": "Deep multi-source research across tasks, documents, document passages, and feedback to answer an open question about the workspace.", "tags": [ "deep research", "investigate", "cross-source", "analysis", "question" ], "tools": [ "inapp__taskQuery", "inapp__documentLookup", "inapp__workContextChunkSearch", "inapp__feedbackQuery", "inapp__memoryQuery" ], "body": "# Deep Research Brief\n\nGoal: answer an open question by triangulating across sources. Read-only.\n\n## 1. Cast a wide net (independent — call together)\n- `inapp__taskQuery` and `inapp__documentLookup` — surface relevant tasks and docs.\n- `inapp__workContextChunkSearch` — pull the exact passages that matter.\n- `inapp__feedbackQuery` and `inapp__memoryQuery` — add customer signal and remembered context.\n\n## 2. Cross-check\nReconcile sources; note where they agree and where they conflict. Cite each claim to its source.\n\n## 3. Answer\nLead with the answer in one sentence, then the evidence, then open questions." }, { "id": "check-external-status", "name": "check-external-status", "description": "Check connected external services — GitHub pull requests, issues, and commits, or PostHog events and sessions — for this workspace.", "tags": [ "github", "pull requests", "my prs", "issues", "posthog", "external", "integrations" ], "tools": [ "inapp__mcpAgent" ], "body": "# Check External Status\n\nGoal: answer a question that lives in a connected external service (GitHub, PostHog), not in Kestral data.\n\n## 1. Route directly\n- `inapp__mcpAgent` — this is the ONLY tool needed. Pass the intent verbatim (e.g. \"my open PRs\", \"recent PostHog errors\"). Do not fan out to workspace query tools.\n\n## 2. Present\nReturn the external items concisely (PR/issue titles + links, or event summaries). One hop — no delegation chain." }, { "id": "document-lookup-and-read", "name": "document-lookup-and-read", "description": "Find a specific document or spec and read the relevant passages, returning cited content and its extracted knowledge.", "tags": [ "documents", "spec", "read", "find doc", "reference", "lookup" ], "tools": [ "inapp__documentLookup", "inapp__workContextChunkSearch", "inapp__contextKnowledgeQuery" ], "body": "# Document Lookup and Read\n\nGoal: locate the right document and surface exactly the passage the user needs. Read-only.\n\n## 1. Locate\n- `inapp__documentLookup` — find the doc by topic/type.\n\n## 2. Read\n- `inapp__workContextChunkSearch` — pull the relevant passages from that doc.\n- `inapp__contextKnowledgeQuery` — add any extracted summary/decisions if useful.\n\n## 3. Present\nQuote the passage(s) with the document title as citation; keep it tight." } ] }