rill

Generate today's Daily Note (or one for a specified date) at reports/daily/YYYY-MM-DD.md by aggregating the day's situation across journals, tasks, workspaces, knowledge, activity-log, and any plugin briefing hooks. Fully automated, no interaction. Use when the user asks for a daily briefing, situational analysis, or "what's going on today/yesterday".

Ingest a single Twitter/X tweet URL into inbox/tweets/, fetch its content via fetch-tweet.sh, and generate an organized version with frontmatter and Markdown body in _organized/. Combines `rill clip` with the tweet branch of /distill Phase 2 in one shot. Use when the user supplies a single tweet URL to capture.

Quantitatively evaluate the search quality and efficiency of the Rill knowledge base via natural exploration vs Deep Path ground truth (ADR-050). Run monthly. Computes precision, recall, metadata_contribution, token cost. Use when the user wants to verify whether note structure actually works in practice.

Start (or resume) a Rill workspace from a theme, journal file, or workspace id. Automatically collects related vault context and creates a workspace/{id}/ directory for an interactive Deep Think session. Use when the user wants to begin or continue a workspace-scoped exploration.

Diagnose Rill PKM taxonomy health, metadata accuracy, and file integrity. Run weekly. Detects issues and appends mismatched files to knowledge/.refresh-queue for repair by /repair.

Run note quality maintenance — invoke /inspect to diagnose vault metadata, then /repair to fix queued issues. Use when the user wants weekly or periodic Rill vault health maintenance.

Run the daily morning routine — invoke /briefing (Daily Note) followed by /newsletter (research report) inline within the current session. Use when the user starts the day or explicitly asks for the morning routine.

Generate today's daily news report at reports/newsletter/YYYY-MM-DD.md by performing WebSearch + WebFetch over the user's 3-layer context (Identity / Attention / Impulse) and producing Alert + Deep Dive + Discovery sections. Fully automated. Use when the user asks for the daily research newsletter.

Guide a new user through a 5-8 minute first-time Rill setup — language detection, first journal entry, core concepts (/focus + /distill), an "ask the assistant" prompt, optional morning reminder, and optional Rill app install on macOS. Use when the user runs first-time setup or asks for a tutorial.

Have a conversation with a Rill page (pages/{id}.md). Pages evolve through dialogue and incremental edits, not regeneration. Supports conversational session, quick update, page creation, and last-resort full rebuild. Use when the user wants to update, query, or create a Materialized View page.

Manage Rill plugins interactively (lifecycle: available → install → enable → disable → uninstall). Use when the user wants to install, enable, disable, uninstall, or check the state of plugins, or to search for available plugins.

Operate on a project execution hub via six modes — `status` (one-project overview), `continue` (next unblocked task → /solve), `run` (policy-gated autonomous loop that solves tasks until a stop condition), `review` (dependency-tree audit), `list` (cross-project), `new` (create). Each mode auto-runs `/refresh-project` first. Use when the user wants to check a project, pick the next task, autonomously work a whole project, or see what's actionable across projects.

Crystallise a closed workspace's results into its target project. Reads `_summary.md`, proposes Key Facts + Related Workspaces references + new tasks, appends on approval. The bridge between divergent thinking (`/focus`) and convergent execution (`/project`). Use after `/close` has produced `_summary.md`.

Refresh knowledge/self/current-state.md — a triaged 80-line/7-section snapshot of the user's current state (direction / active workspaces / open tasks / recent decisions / open questions / execution gaps / known contradictions). Called manually, or auto-chained from /distill + /close, or on-demand by /briefing when the snapshot is stale. Use when the user asks for "current state" (in any language) / "what's going on across my workspaces", or when a higher-level skill needs a fresh self-snapshot.

Recompute the `## Pending Decisions` digest section of `projects/{slug}/_project.md` by collecting line-start `[DECISION-QUEUE]` markers from the project's tasks and the project file itself (decision-loop contract v1.1, ADR-084). Deterministic grep-render-replace, no LLM judgment, idempotent. Use after an agent queues a decision, after a human resolves one, or as a leaf invoked by other skills.

Recompute the auto-maintained sections (`## Active Tasks`, `## Related Workspaces`) of `projects/{slug}/_project.md` via mention reverse-lookup, sorted by dependency-resolved priority. Idempotent. Use when refreshing a project's surface, or as a leaf invoked internally by `/project` and `/promote`.

Batch-update knowledge/notes/ frontmatter (tags, mentions, type) for files queued by /inspect. Reads `knowledge/.refresh-queue` and dispatches parallel sub-agents to repair metadata. Use when the user wants to fix queued metadata issues, typically right after /inspect.

Generate a weekly retrospective at reports/retrospective/weekly-{YYYY-MM-DD}.md with 5 sections (Cross-WS Themes / Contradictions / Stale Workspaces / Decision Digest / Self Observations) over the prior ISO week. Auto-appends to knowledge/self/decisions.md (3-month window) and surfaces Self Observation candidates for --finalize approval. Primary habit trigger is the Thursday /briefing nudge. Use when the user runs `/retrospective`, asks for a weekly review, or the briefing nudge requests it.

Execute a Rill task ticket end-to-end via a Plan-gated autonomous flow (ADR-081 two lanes). Phase 3 Plan approval is the only user gate; Phase 4/5 run autonomously. Delegated from /project run, it executes in autonomous mode (policy + Codex PASS replace per-task approval; decision points queue). Resumable via `## Current Position` in `_task.md`.

Run all enabled plugins sequentially to bulk-sync external sources (Google Meet, Twitter, voice memo, web clipper, etc.). Use when the user wants to pull in fresh entries from configured external sources, or when chaining batch ingestion before /distill.