Bypass init wizard for explicit skill action flags

Update docs and tests to clarify that --install-skill and
--uninstall-skill
now skip auto-wizard mode unless --wizard is specified. Clean up skill
package docs and installer references.

Author: BumpyClock

.tasque/events.jsonl

@@ -1011,3 +1011,6 @@
 {"id":"01KHSCCH64WY6MW1GCM3RM55NK","event_id":"01KHSCCH64WY6MW1GCM3RM55NK","ts":"2026-02-18T22:02:02.308Z","actor":"BumpyClock","type":"task.created","task_id":"tsq-3r9qk99s","payload":{"id":"tsq-3r9qk99s","title":"Refactor skill installer to copy SKILLS/<name> source directory","kind":"task","priority":1,"status":"open","planning_state":"planned"}}
 {"id":"01KHSCCQWT4JKXY3EVCHSGRZTJ","event_id":"01KHSCCQWT4JKXY3EVCHSGRZTJ","ts":"2026-02-18T22:02:09.178Z","actor":"BumpyClock","type":"task.claimed","task_id":"tsq-3r9qk99s","payload":{"assignee":"codex"}}
 {"id":"01KHSDRYBYVR8J2QMSVT6QHABR","event_id":"01KHSDRYBYVR8J2QMSVT6QHABR","ts":"2026-02-18T22:26:17.598Z","actor":"BumpyClock","type":"task.status_set","task_id":"tsq-3r9qk99s","payload":{"status":"closed","closed_at":"2026-02-18T22:26:17.598Z"}}
+{"id":"01KHSFP1H5PGGDMVRM1ZXNSB70","event_id":"01KHSFP1H5PGGDMVRM1ZXNSB70","ts":"2026-02-18T22:59:39.685Z","actor":"BumpyClock","type":"task.created","task_id":"tsq-zzzkgbpf","payload":{"id":"tsq-zzzkgbpf","title":"Bypass init wizard when explicit skill action flags are passed","kind":"task","priority":1,"status":"open","planning_state":"planned"}}
+{"id":"01KHSFP922YYP8HQAN0541D4ZQ","event_id":"01KHSFP922YYP8HQAN0541D4ZQ","ts":"2026-02-18T22:59:47.394Z","actor":"BumpyClock","type":"task.claimed","task_id":"tsq-zzzkgbpf","payload":{"assignee":"codex"}}
+{"id":"01KHSFV4SQ553CAX9J1HSG61J8","event_id":"01KHSFV4SQ553CAX9J1HSG61J8","ts":"2026-02-18T23:02:26.871Z","actor":"BumpyClock","type":"task.status_set","task_id":"tsq-zzzkgbpf","payload":{"status":"closed","closed_at":"2026-02-18T23:02:26.871Z"}}

LEARNINGS.md

@@ -42,6 +42,7 @@
 ## Init UX
 - Wizard contract baseline: run `tsq init` wizard only on TTY by default; `--no-wizard` is authoritative; `--wizard` is TTY-only; non-interactive agent flows must remain fully deterministic via flags.
 - Refined wizard UX contract (docs/design/init-wizard-design.md): preserve a 4-step max flow, always show resolved plan before writes, treat `--yes` as wizard auto-accept (no-op outside wizard), and keep preset semantics deterministic (`minimal`, `standard`, `full`) with explicit-flags-over-preset precedence.
+- Explicit skill actions (`--install-skill` / `--uninstall-skill`) should bypass auto-wizard mode so `tsq init` executes immediately; `--wizard` is still available to force interactive flow.
 
 ## Recent Updates
 - 2026-02-18: Event parsing now uses Zod at JSONL boundaries; canonical event field is `id` while reads still accept legacy `event_id`.

README.md

@@ -163,6 +163,7 @@ Skill installer via `init`:
 
 - `tsq init --install-skill`
 - `tsq init --uninstall-skill`
+- Explicit `--install-skill` / `--uninstall-skill` bypasses auto-wizard mode by default. Use `--wizard` if you want interactive prompts.
 - `--skill-targets claude,codex,copilot,opencode|all` (default `all`)
 - `--skill-name <name>` (default `tasque`)
 - `--force-skill-overwrite` (overwrite unmanaged skill dirs)

SKILLS/tasque/README.md

@@ -5,9 +5,9 @@ Managed skill package for `tsq`.
 
 ## Files
 
-- `SKILL.md`: focused operational guide for `tsq` (load first)
-- `README.md`: installer metadata and summary
-- `references/`: optional deep-dive docs (planning, command catalog, durability, checklists)
+- `SKILL.md`: operational guide for `tsq`
+- `README.md`: installer metadata and managed marker
+- `references/`: additional docs copied during install
 - `scripts/`: optional helper scripts copied during install
 
 ## Safety

SKILLS/tasque/SKILL.md

@@ -5,7 +5,20 @@ description: Operational guide for Tasque (tsq) local task tracking and manageme
 
 <!-- tsq-managed-skill:v1 -->
 
-
+Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
+
+**When to use tsq**:
+- Work spans multiple sessions or days
+- Tasks have dependencies or blockers
+- Need to survive conversation compaction
+- Exploratory/research work with fuzzy boundaries
+- Collaboration with team (git sync)
+
+**When to use native task tool**:
+- Single-session linear tasks
+- Simple checklist for immediate work
+- All context is in current conversation
+- Will complete within current session
 
 Durable task tracking via `tsq`.
 

SKILLS/tasque/references/README.md

@@ -80,7 +80,9 @@ export function resolveInitPlan(
     throw new TsqError("VALIDATION_ERROR", "--preset is not supported with --json", 1);
   }
 
-  const wizardEnabled = !hasNoWizard && (hasWizard || (context.isTTY && !context.json));
+  const hasExplicitSkillAction = Boolean(options.installSkill || options.uninstallSkill);
+  const wizardEnabled =
+    !hasNoWizard && (hasWizard || (!hasExplicitSkillAction && context.isTTY && !context.json));
   if (!wizardEnabled) {
     return {
       mode: "non_interactive",

SKILLS/tasque/scripts/README.md

@@ -402,8 +402,8 @@ describe("cli e2e", () => {
       const skillPath = join(rootDir, "tasque");
       expect(await pathExists(join(skillPath, "SKILL.md"))).toBe(true);
       expect(await pathExists(join(skillPath, "README.md"))).toBe(true);
-      expect(await pathExists(join(skillPath, "references", "README.md"))).toBe(true);
-      expect(await pathExists(join(skillPath, "scripts", "README.md"))).toBe(true);
+      expect(await pathExists(join(skillPath, "references", "planning-workflow.md"))).toBe(true);
+      expect(await pathExists(join(skillPath, "scripts"))).toBe(true);
     }
   });
 

src/cli/init-flow.ts

@@ -69,6 +69,16 @@ describe("init flow resolution", () => {
     expect(plan.mode).toBe("non_interactive");
   });
 
+  it("disables auto wizard in tty mode when explicit skill action is provided", () => {
+    const plan = resolve({ installSkill: true }, ["init", "--install-skill"], { isTTY: true });
+    expect(plan.mode).toBe("non_interactive");
+    if (plan.mode !== "non_interactive") {
+      throw new Error("expected non_interactive mode");
+    }
+    expect(plan.input.installSkill).toBe(true);
+    expect(plan.input.uninstallSkill).toBe(false);
+  });
+
   it("marks wizard plan as auto-accept when --yes is provided", () => {
     const plan = resolve({ yes: true }, ["init"], { isTTY: true });
     expect(plan.mode).toBe("wizard");
@@ -108,11 +118,12 @@ describe("init flow resolution", () => {
       ["init", "--preset", "full", "--uninstall-skill"],
       { isTTY: true },
     );
-    expect(plan.mode).toBe("wizard");
-    if (plan.mode !== "wizard") {
-      throw new Error("expected wizard mode");
+    expect(plan.mode).toBe("non_interactive");
+    if (plan.mode !== "non_interactive") {
+      throw new Error("expected non_interactive mode");
     }
-    expect(plan.seed.action).toBe("uninstall");
+    expect(plan.input.uninstallSkill).toBe(true);
+    expect(plan.input.installSkill).toBe(false);
   });
 
   it("uses explicit skill targets over preset defaults", () => {