From cbf0d71885cb9c4189e0ba7077691505bc5b7726 Mon Sep 17 00:00:00 2001 From: RuiAlonso Date: Thu, 9 Apr 2026 14:25:56 +0200 Subject: [PATCH 1/2] feat: extracted shared clear context handoff to shared reference --- skills/brainstorm/SKILL.md | 14 ++--------- skills/plan-technical-review/SKILL.md | 12 +--------- skills/plan/SKILL.md | 13 +--------- skills/refine-approach/SKILL.md | 24 ++----------------- .../references/clear-context-handoff.md | 18 ++++++++++++++ 5 files changed, 24 insertions(+), 57 deletions(-) create mode 100644 skills/shared/references/clear-context-handoff.md diff --git a/skills/brainstorm/SKILL.md b/skills/brainstorm/SKILL.md index 13ae5f1..ded7f41 100644 --- a/skills/brainstorm/SKILL.md +++ b/skills/brainstorm/SKILL.md @@ -177,23 +177,13 @@ Use **AskUserQuestion tool** to consider next steps: 3. **Review and refine approach:** improve the document using structured review 4. **Done for now**: brainstorm complete. To start planning later: `/plan` -**If the user selects "Clear context and plan"** → output the following (substituting the actual brainstorm doc path) and then stop: - -```md -To continue with a fresh context, run: - -/clear - -Then start planning with: - -/plan docs/brainstorm/.md -``` +**If the user selects "Clear context and plan"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. **If the user selects "Review and refine approach"** then apply the @refine-approach skill to the document. When `refine-approach` is complete, present these options: -1. **Clear context and plan**: clear context for a fresh start, then plan +1. **Clear context and plan**: follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` 2. **Move to planning**: run the `/plan` skill to create a detailed implementation plan 3. **Done for now**: ideation complete. To start planning later: `/plan` diff --git a/skills/plan-technical-review/SKILL.md b/skills/plan-technical-review/SKILL.md index d051745..26dd224 100644 --- a/skills/plan-technical-review/SKILL.md +++ b/skills/plan-technical-review/SKILL.md @@ -43,16 +43,6 @@ If the plan-splitting-agent reports no split needed: include the scope summary i 3. **Refine the plan**: improve the plan based on review findings 4. **Done for now**: review complete -**If the user selects "Clear context and build"** → output the following (substituting the actual plan file path) and then stop: - -```md -To continue with a fresh context, run: - -/clear - -Then start building with: - -/build docs/plan/.md -``` +**If the user selects "Clear context and build"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. **When invoked by another skill** (e.g., from `/plan`), return control to the caller after the review completes — do not present handoff options. diff --git a/skills/plan/SKILL.md b/skills/plan/SKILL.md index 625efc8..460cf97 100644 --- a/skills/plan/SKILL.md +++ b/skills/plan/SKILL.md @@ -265,18 +265,7 @@ After writing the plan file, use the **AskUserQuestion tool** and present the fo Based on selection: -- **Clear context and build** → Output the following (substituting the actual plan file path) and then stop: - - ```md - To continue with a fresh context, run: - - /clear - - Then start building with: - - /build docs/plan/.md - ``` - +- **Clear context and build** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. - **Start building** → Call the `/build` skill with the plan file path - **Open plan in editor** → Run `open docs/plan/.md` to open the file in the user's default editor - **`/plan-technical-review`** → Call the `/plan-technical-review` skill with the plan file path diff --git a/skills/refine-approach/SKILL.md b/skills/refine-approach/SKILL.md index 4a9532a..8b037bc 100644 --- a/skills/refine-approach/SKILL.md +++ b/skills/refine-approach/SKILL.md @@ -91,29 +91,9 @@ After changes are complete, ask: 2. **Refine again** — another review pass 3. **Done for now** — document is ready -**If the user selects "Clear context and plan"** → output the following (substituting the actual brainstorm doc path) and then stop: +**If the user selects "Clear context and plan"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. -```md -To continue with a fresh context, run: - -/clear - -Then start planning with: - -/plan docs/brainstorm/.md -``` - -**If the user selects "Clear context and build"** → output the following (substituting the actual plan file path) and then stop: - -```md -To continue with a fresh context, run: - -/clear - -Then start building with: - -/build docs/plan/.md -``` +**If the user selects "Clear context and build"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. **When invoked by another skill** (e.g., from `/brainstorm` or `/plan`), only offer "Refine again" and "Review complete", then return control to the caller. diff --git a/skills/shared/references/clear-context-handoff.md b/skills/shared/references/clear-context-handoff.md new file mode 100644 index 0000000..912382b --- /dev/null +++ b/skills/shared/references/clear-context-handoff.md @@ -0,0 +1,18 @@ +# Clear Context Handoff + +When a "Clear context and [next step]" option is selected, output the following block (substituting the actual skill and document path) and then **stop**: + +```md +To continue with a fresh context, run: + +/clear + +Then start with: + +/ +``` + +Where: +- `` — the verb for the next phase (e.g., "planning", "building") +- `` — the skill to invoke (e.g., `plan`, `build`) +- `` — the full path to the document produced in the current phase From 0051464b861c7fb991750f6e32f0bf1605abe742 Mon Sep 17 00:00:00 2001 From: RuiAlonso Date: Fri, 10 Apr 2026 10:30:26 +0200 Subject: [PATCH 2/2] fix: referencess symlink --- skills/brainstorm/SKILL.md | 4 ++-- skills/brainstorm/references/clear-context-handoff.md | 1 + skills/plan-technical-review/SKILL.md | 2 +- .../plan-technical-review/references/clear-context-handoff.md | 1 + skills/plan/SKILL.md | 2 +- skills/plan/references/clear-context-handoff.md | 1 + skills/refine-approach/SKILL.md | 4 ++-- skills/refine-approach/references/clear-context-handoff.md | 1 + 8 files changed, 10 insertions(+), 6 deletions(-) create mode 120000 skills/brainstorm/references/clear-context-handoff.md create mode 120000 skills/plan-technical-review/references/clear-context-handoff.md create mode 120000 skills/plan/references/clear-context-handoff.md create mode 120000 skills/refine-approach/references/clear-context-handoff.md diff --git a/skills/brainstorm/SKILL.md b/skills/brainstorm/SKILL.md index ded7f41..5b93e0a 100644 --- a/skills/brainstorm/SKILL.md +++ b/skills/brainstorm/SKILL.md @@ -177,13 +177,13 @@ Use **AskUserQuestion tool** to consider next steps: 3. **Review and refine approach:** improve the document using structured review 4. **Done for now**: brainstorm complete. To start planning later: `/plan` -**If the user selects "Clear context and plan"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. +**If the user selects "Clear context and plan"** → Follow the [clear context handoff](references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. **If the user selects "Review and refine approach"** then apply the @refine-approach skill to the document. When `refine-approach` is complete, present these options: -1. **Clear context and plan**: follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` +1. **Clear context and plan**: follow the [clear context handoff](references/clear-context-handoff.md) for `/plan` 2. **Move to planning**: run the `/plan` skill to create a detailed implementation plan 3. **Done for now**: ideation complete. To start planning later: `/plan` diff --git a/skills/brainstorm/references/clear-context-handoff.md b/skills/brainstorm/references/clear-context-handoff.md new file mode 120000 index 0000000..18bd754 --- /dev/null +++ b/skills/brainstorm/references/clear-context-handoff.md @@ -0,0 +1 @@ +../../shared/references/clear-context-handoff.md \ No newline at end of file diff --git a/skills/plan-technical-review/SKILL.md b/skills/plan-technical-review/SKILL.md index 26dd224..17c1b34 100644 --- a/skills/plan-technical-review/SKILL.md +++ b/skills/plan-technical-review/SKILL.md @@ -43,6 +43,6 @@ If the plan-splitting-agent reports no split needed: include the scope summary i 3. **Refine the plan**: improve the plan based on review findings 4. **Done for now**: review complete -**If the user selects "Clear context and build"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. +**If the user selects "Clear context and build"** → Follow the [clear context handoff](references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. **When invoked by another skill** (e.g., from `/plan`), return control to the caller after the review completes — do not present handoff options. diff --git a/skills/plan-technical-review/references/clear-context-handoff.md b/skills/plan-technical-review/references/clear-context-handoff.md new file mode 120000 index 0000000..18bd754 --- /dev/null +++ b/skills/plan-technical-review/references/clear-context-handoff.md @@ -0,0 +1 @@ +../../shared/references/clear-context-handoff.md \ No newline at end of file diff --git a/skills/plan/SKILL.md b/skills/plan/SKILL.md index 460cf97..84f4799 100644 --- a/skills/plan/SKILL.md +++ b/skills/plan/SKILL.md @@ -265,7 +265,7 @@ After writing the plan file, use the **AskUserQuestion tool** and present the fo Based on selection: -- **Clear context and build** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. +- **Clear context and build** → Follow the [clear context handoff](references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. - **Start building** → Call the `/build` skill with the plan file path - **Open plan in editor** → Run `open docs/plan/.md` to open the file in the user's default editor - **`/plan-technical-review`** → Call the `/plan-technical-review` skill with the plan file path diff --git a/skills/plan/references/clear-context-handoff.md b/skills/plan/references/clear-context-handoff.md new file mode 120000 index 0000000..18bd754 --- /dev/null +++ b/skills/plan/references/clear-context-handoff.md @@ -0,0 +1 @@ +../../shared/references/clear-context-handoff.md \ No newline at end of file diff --git a/skills/refine-approach/SKILL.md b/skills/refine-approach/SKILL.md index 8b037bc..3bff473 100644 --- a/skills/refine-approach/SKILL.md +++ b/skills/refine-approach/SKILL.md @@ -91,9 +91,9 @@ After changes are complete, ask: 2. **Refine again** — another review pass 3. **Done for now** — document is ready -**If the user selects "Clear context and plan"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. +**If the user selects "Clear context and plan"** → Follow the [clear context handoff](references/clear-context-handoff.md) for `/plan` with the actual brainstorm doc path. Then stop. -**If the user selects "Clear context and build"** → Follow the [clear context handoff](../shared/references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. +**If the user selects "Clear context and build"** → Follow the [clear context handoff](references/clear-context-handoff.md) for `/build` with the actual plan file path. Then stop. **When invoked by another skill** (e.g., from `/brainstorm` or `/plan`), only offer "Refine again" and "Review complete", then return control to the caller. diff --git a/skills/refine-approach/references/clear-context-handoff.md b/skills/refine-approach/references/clear-context-handoff.md new file mode 120000 index 0000000..18bd754 --- /dev/null +++ b/skills/refine-approach/references/clear-context-handoff.md @@ -0,0 +1 @@ +../../shared/references/clear-context-handoff.md \ No newline at end of file