waggle

Generates Acceptance Criteria and Execution Plans for code/technical tasks by exploring the codebase. Returns structured text to the caller.

Generates Acceptance Criteria and Execution Plans for non-code knowledge work tasks (marketing, operations, research, coordination, etc.). Uses domain-specific templates and progressive clarification.

Executes a single development task autonomously. Use when the task-agent skill delegates a Ready task for execution. Reads task description and acceptance criteria, plans implementation, writes code, runs tests.

Shared logic for resetting fields when assigning a task to another person. Enforces standard field constraints so the recipient can configure their own execution environment. Called by managing-tasks, delegating-tasks, and ingesting-messages.

Shared session bootstrap — detects provider, resolves identity, and populates headless_config. Called by all user-invocable skills at startup.

Delegates a task to another organization member by updating Assignee, resetting executor fields, and recording delegation history in Context. Use this skill whenever the user wants to hand off, transfer, reassign, or give a task to someone else — even if they don't say "delegate" explicitly. Triggers on: "delegate task", "assign to", "transfer task", "reassign", "hand off", "give to", "pass to another person".

Detects the active data source provider and retrieves configuration (database IDs, constants). Internal shared skill — not for direct user invocation.

Orchestrates autonomous task execution via current session, tmux parallel, or Scheduled Tasks. Fetches ready tasks, validates working directories, and dispatches to the chosen execution mode. Use this skill whenever the user wants to do, run, process, start, dispatch, or launch tasks — including parallel execution, batch processing, or working on the next ready task. Triggers on: "do the next task", "process tasks", "execute tasks", "ready tasks", "run tasks", "start tasks", "dispatch", "launch tasks", "work on next task", "parallel execution", "batch process".

Checks waggle configuration health: Scheduled Task remnants, custom intake settings, config.json migration status, and Notion Desktop Extension version. Triggers on: "health check", "check config", "check setup", "ヘルスチェック", "設定チェック", "設定確認"

Reads incoming messages (Slack, Teams, Discord) and custom intake sources addressed to the current user and auto-converts them into categorized tasks (hearing-needed, self-action, or delegate). For ambiguous Slack messages in an explicitly interactive session, can optionally send a user-approved clarification reply in-thread instead of creating a hearing-task pair. Supports per-user custom source configuration via ~/.waggle/intake-prompt.md or Global Instructions, and per-user task-creation rules (tag naming, priority defaults, etc.) via ~/.waggle/task-creation-prompt.md or Global Instructions. Use this skill whenever the user wants to process incoming messages, check their inbox, or convert messages into tasks — even if they don't say "intake". Triggers on: "message intake", "intake", "process messages", "convert messages to tasks", "check slack", "check teams", "inbox processing", "clarify slack message".

Shared loader for environment-aware custom instructions. Given an instruction key (e.g. `task-creation`, `intake`), returns the user-defined custom instructions for the current execution environment — file-based on CLI / Claude Desktop, system-prompt XML tags on Cowork. Internal shared skill — not for direct user invocation.

Internal shared skill to resolve member names or email addresses to provider user IDs. Not intended for direct user invocation.

Creates, updates, deletes, and queries tasks in the configured data source. Handles task creation with required confirmations, state transitions, "next task" recommendations, and personal task dashboard. Use this skill for ANY task-related request — creating, updating, deleting, querying, listing, filtering by status/priority/assignee, marking done, blocking, assigning, changing priority, viewing personal dashboards, or asking "what's next". If the user mentions tasks in any way, use this skill. Triggers on: "add task", "create task", "update task", "done", "change status", "list tasks", "what's next", "next task", "block", "assign", "prioritize", "show tasks", "get tasks", "fetch tasks", "my tasks", "assigned to me", "show my tasks", "what are my tasks".

Creates, lists, deletes, and regenerates custom task visualizations. Use this skill whenever the user wants to create, delete, customize, or manage saved task visualizations — custom dashboards, filtered boards, or personalized views. Triggers on: "create view", "custom view", "make a dashboard", "view of", "delete view", "list views", "regenerate view", "my view", "build a board", "design visualization".

Performs a health check on tasks. Analyzes task age (stagnation), field completeness by status, blocked tasks (including other assignees' blockers), and executor ratio (human vs AI delegation). Supports 3 modes: specific assignee (by name), all tasks (team-wide overview), or defaults to current user when no target is specified. Use this skill whenever the user wants to monitor task health, check stagnation, audit task quality, or review AI delegation metrics — even if they don't say "monitor" explicitly. Triggers on: "monitor tasks", "task health check", "task analysis", "stagnation report", "task monitoring", "task report"

Generates or refines Acceptance Criteria and Execution Plans for tasks. Single task or batch mode. Ensures tasks are executable at agent-autonomous quality. Uses multi-round brainstorming to extract quality information from users. Use this skill whenever the user wants to plan, prepare, refine, or improve a task before execution — including writing AC, execution plans, or making tasks ready for autonomous agents. Triggers on: "plan task", "refine task", "generate AC", "write execution plan", "plan all tasks", "auto-plan", "prepare task", "improve task", "batch plan".

Waggle provider plugin development guide and interface contract. Defines the required SKILL.md sections, data shapes, naming conventions, and compliance checklist for building a waggle provider plugin. Trigger on: "provider contract", "provider interface", "create provider plugin", "new provider", "provider compliance", "how to build a provider".

Internal shared skill to resolve current user identity and org members. Not intended for direct user invocation.

Unified daily routine: ingests messages into tasks, then guides user through task refinement and dispatch. Works in both Terminal CLI and Claude Desktop. Use this skill whenever the user wants to start their day, run a morning routine, or process their daily task workflow — even if they just ask "what should I do today?". Triggers on: "daily tasks", "daily routine", "run daily tasks", "morning routine", "start my day", "what should I do today", "daily run".

Guides initial setup of the waggle plugin — detects or configures MCP connections and runs provider-specific database initialization. Use this skill whenever the user wants to set up, initialize, or configure waggle for the first time, or connect a new data source provider. Triggers on: "setup waggle", "initialize task management", "configure notion tasks", "configure data source", "get started with waggle", "first-time setup", "connect provider".

Diagnoses common Waggle issues: schema mismatches, missing fields, stale views, broken ingestion, and version incompatibilities. Use when something isn't working as expected — errors, missing data, unexpected behavior, or after upgrading Waggle. Triggers on: "troubleshoot", "debug", "not working", "error", "something is wrong", "broken", "help me fix".

Deterministic field validation for task status transitions. Returns pass/fail with errors and warnings as JSON. Used by managing-tasks, executing-tasks, and running-daily-tasks.

Manages the local view server that renders task data as interactive HTML pages (Kanban, List, Calendar, Gantt). Starts the server, pushes data, and opens views. Use this skill whenever the user wants to see tasks visually — board views, timelines, calendars, or any kind of task visualization or dashboard display. Triggers on: "kanban", "list view", "show tasks", "view", "visualize", "gantt", "calendar", "board", "timeline", "display tasks", "open dashboard".

Waggle Protocol v1 specification. Defines the 15 core fields, 9 extended fields, task state machine, dispatch readiness checks, and execution environments. Use this skill when you need to understand the waggle protocol, check field definitions, or verify state transitions. Trigger on: "protocol spec", "waggle spec", "field definitions", "state machine", "task schema", "core fields".