kazukinagata/waggle

notion-provider

Notion-specific provider implementation for waggle. Loaded when the active provider is notion.

validating-fields

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.

monitoring-tasks

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…

managing-tasks

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 — create,…

running-daily-tasks

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…

reviewing-quality

Shared skill that owns the Quality Verdict pipeline for waggle tasks. Combines the deterministic structural checks (Layer 1) and the task-quality-reviewer-agent (Layer 2 IRC) behind a single contract. Manages the content-hash cache, batch fan-out, and…

waggle-protocol

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…

delegating-tasks

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…

planning-tasks

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…

ingesting-messages

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…

assigning-to-others

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.

provider-contract

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",…

executing-tasks

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,…

turso-provider

Turso-specific implementation for waggle. Loaded by detecting-provider when active_provider is turso.

loading-custom-instructions

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…

managing-views

Creates, lists, deletes, and regenerates custom task visualizations. In cli / claude-desktop they are HTML files served by the local view server. In Cowork each custom view is registered as its own Live Artifact (id `waggle-view-{slug}`) that fetches data via…

setting-up-tasks

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…

viewing-tasks

Renders task data as interactive HTML dashboards (Kanban, List, Calendar, Gantt). In cli / claude-desktop the dashboard is served by a local view server on localhost:3456. In Cowork the dashboard is registered as a Live Artifact that fetches Notion data…

notion-setup

Set up Notion as the waggle provider. Trigger phrases - "setup notion", "configure notion for waggle".

sqlite-setup

Set up SQLite as the waggle provider. Trigger phrases - "setup sqlite", "configure sqlite for waggle".

sqlite-provider

SQLite-specific provider implementation for waggle. Loaded when the active provider is sqlite.

bootstrap-session

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

detecting-provider

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

health-checking

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", "ヘルスチェック", "設定チェック", "設定確認"

looking-up-members

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

resolving-identity

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

troubleshooting

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:…

turso-setup

Set up Turso as the waggle provider. Trigger phrases - "setup turso", "configure turso for waggle".