From c8703a6058e6974fd8ed949d22fd8bae9da3af2e Mon Sep 17 00:00:00 2001 From: Amolith Date: Sun, 28 Dec 2025 08:50:33 -0700 Subject: [PATCH] feat: add Lunatask deferral and resumption skills Paired workflow skills for capturing work to resume later: - deferring-work-through-lunatask: creates tasks with rich context - resuming-work-through-lunatask: picks up deferred work safely Both include CLI fallback references and installation guidance. Assisted-by: Claude Opus 4.5 via Crush --- README.md | 6 ++ .../deferring-work-through-lunatask/SKILL.md | 78 +++++++++++++++++++ .../references/cli.md | 38 +++++++++ .../references/installing-lune.md | 1 + .../resuming-work-through-lunatask/SKILL.md | 21 +++++ .../references/cli.md | 25 ++++++ .../references/installing-lune.md | 1 + 7 files changed, 170 insertions(+) create mode 100644 skills/deferring-work-through-lunatask/SKILL.md create mode 100644 skills/deferring-work-through-lunatask/references/cli.md create mode 100644 skills/deferring-work-through-lunatask/references/installing-lune.md create mode 100644 skills/resuming-work-through-lunatask/SKILL.md create mode 100644 skills/resuming-work-through-lunatask/references/cli.md create mode 100644 skills/resuming-work-through-lunatask/references/installing-lune.md diff --git a/README.md b/README.md index dd6b86337a07afca371efa3994f23be733076792..314da8e2de5cb59aa83391c3156632483888ed62 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,12 @@ agent capabilities through a standardised format. - [resolving-secrets](skills/resolving-secrets/SKILL.md): Wraps shell commands to resolve secret references in environment variables. Use when invoking `synu`, `crush`, `gh`, `hut`, etc. +- [deferring-work-through-lunatask](skills/deferring-work-through-lunatask/SKILL.md): + Captures findings, suggestions, and deferred work items in Lunatask + with rich context for future sessions. +- [resuming-work-through-lunatask](skills/resuming-work-through-lunatask/SKILL.md): + Resumes previously deferred work from Lunatask. Use when user pastes a + task note, shares a deep link, or references continuing earlier work. ## Installation diff --git a/skills/deferring-work-through-lunatask/SKILL.md b/skills/deferring-work-through-lunatask/SKILL.md new file mode 100644 index 0000000000000000000000000000000000000000..ada343302f65e3a0980ca719d1c8a40121e1c265 --- /dev/null +++ b/skills/deferring-work-through-lunatask/SKILL.md @@ -0,0 +1,78 @@ +--- +name: deferring-work-through-lunatask +description: Captures findings, suggestions, and deferred work items in Lunatask with rich context for future sessions. Use when user says "we'll tackle this later", when you suggest improvements the user wants to defer, or when identifying issues to address separately. +compatibility: Requires Lunatask MCP tools or CLI access +license: AGPL-3.0-or-later +metadata: + author: Amolith +--- + +## Formatting + +### Title + +Titles must be: + +- Useful and concise +- Conversational +- Include the project name + +Example: `Implement FunctionSignature(Args) in go-lunatask` + +### Status + +New tasks usually get status `later`. + +### Note structure + +Use `[Title](lunatask://...)` syntax if deep links are needed. + +```markdown +> [Warm, direct message to user—make them smile when they find this later] + +--- + +Hello, future me! o/ + +[Thorough description of the work: what needs doing, why it matters, relevant context discovered during the session] + +[Follow our slow and methodical planning approach: read relevant source code, documentation, and APIs before acting] + +When starting this task, update status according to workflow. When finished, mark `complete`. + +ID: PLACEHOLDER_ID +``` + +After creation, update the note to replace `PLACEHOLDER_ID` with the actual task ID from the creation response. + +### References trailer + +When user references external resources (issues, commits, PRs, tickets), append a `References:` section: + +```markdown +References: + +- https://github.com/user/repo/issues/123 +- project-name/commit/abc123 +- project-name/todo/456 +``` + +Prefer web links; fall back to `project-name/type/id` format. + +## Appending to existing notes + +Only append—never overwrite unless explicitly asked. + +Lunatask only supports full replacement, so reproduce the original note verbatim, then add: + +```markdown +--- + +[New content here] +``` + +Use well-formed markdown with proper whitespace between sections. + +## CLI fallback + +If `lunatask` or `lune` MCP tools are unavailable, see [cli.md](references/cli.md). diff --git a/skills/deferring-work-through-lunatask/references/cli.md b/skills/deferring-work-through-lunatask/references/cli.md new file mode 100644 index 0000000000000000000000000000000000000000..6e279b007769d8283a4d89a775a246e760dc9f2a --- /dev/null +++ b/skills/deferring-work-through-lunatask/references/cli.md @@ -0,0 +1,38 @@ +# CLI Reference + +When MCP tools are unavailable, use `lune` CLI. + +## Creating tasks + +```bash +lune task add "Title" -a AREA_KEY -n "$(cat <<'EOF' +Note content +EOF +)" +``` + + +-a --area Area key (required) +-s --status Status (workflow-dependent) +-n --note Task note (use - for stdin) +-g --goal Goal key + + +Output includes the task ID needed to replace `PLACEHOLDER_ID` in the note. + +## Updating notes + +```bash +lune task update ID -n "$(cat <<'EOF' +Full replacement content +EOF +)" +``` + +Notes are replaced entirely—reproduce original content when appending. + +## Listing areas + +```bash +lune area list +``` diff --git a/skills/deferring-work-through-lunatask/references/installing-lune.md b/skills/deferring-work-through-lunatask/references/installing-lune.md new file mode 100644 index 0000000000000000000000000000000000000000..765006d6957b5b5ce2d4dbaa0fca51562b36aed8 --- /dev/null +++ b/skills/deferring-work-through-lunatask/references/installing-lune.md @@ -0,0 +1 @@ +Read through https://git.secluded.site/lune/blob/main/README.md?raw=1 and help the user through installing/setting up either lune's CLI or MCP. The CLI with this skill would be more efficient for e.g. coding agents, but the MCP server is required for integrating with something like Home Assistant. diff --git a/skills/resuming-work-through-lunatask/SKILL.md b/skills/resuming-work-through-lunatask/SKILL.md new file mode 100644 index 0000000000000000000000000000000000000000..cdbd95085240bbf1a7010355edc0e1720f32d292 --- /dev/null +++ b/skills/resuming-work-through-lunatask/SKILL.md @@ -0,0 +1,21 @@ +--- +name: resuming-work-through-lunatask +description: Resumes previously deferred work from Lunatask. Use when user pastes a task note, shares a lunatask:// deep link, says "let's pick this up", or references continuing earlier work. +compatibility: Requires Lunatask MCP tools or CLI access +license: AGPL-3.0-or-later +metadata: + author: Amolith +--- + +Treat the provided plan as **high-level suggestions only**. Before acting: + +1. Read relevant source code, documentation, and library APIs +2. Verify the plan is still accurate, necessary, and beneficial +3. If deviations exist between the plan and current state: + - Stop + - Summarize the deviations + - Wait for user input before proceeding + +## CLI fallback + +If `lunatask` or `lune` MCP tools are unavailable, see [cli.md](references/cli.md). diff --git a/skills/resuming-work-through-lunatask/references/cli.md b/skills/resuming-work-through-lunatask/references/cli.md new file mode 100644 index 0000000000000000000000000000000000000000..e066dc1b735e423cb58f774e8a533fb238301a3f --- /dev/null +++ b/skills/resuming-work-through-lunatask/references/cli.md @@ -0,0 +1,25 @@ +# CLI Reference + +When MCP tools are unavailable, use `lune` CLI. + +## Showing task details + +```bash +lune task show ID +``` + +Accepts UUID or `lunatask://` deep link. Due to encryption, name/note aren't visible—only metadata. + +## Updating status + +```bash +lune task update ID -s STATUS +``` + +Valid statuses depend on the area's workflow (see `lune area list`). + +## Marking complete + +```bash +lune done ID +``` diff --git a/skills/resuming-work-through-lunatask/references/installing-lune.md b/skills/resuming-work-through-lunatask/references/installing-lune.md new file mode 100644 index 0000000000000000000000000000000000000000..765006d6957b5b5ce2d4dbaa0fca51562b36aed8 --- /dev/null +++ b/skills/resuming-work-through-lunatask/references/installing-lune.md @@ -0,0 +1 @@ +Read through https://git.secluded.site/lune/blob/main/README.md?raw=1 and help the user through installing/setting up either lune's CLI or MCP. The CLI with this skill would be more efficient for e.g. coding agents, but the MCP server is required for integrating with something like Home Assistant.