Agent skill

session-mode-init

Loaded at session start when spellbook_session_init returns mode data, or when mode.type is 'unset'. Triggers: session init mode handling, '/mode', mode selection, 'fun mode', 'tarot mode'.

Stars 5
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/axiomantic/spellbook/tree/main/skills/session-mode-init

SKILL.md

Session Mode Init

Invariant Principles

  1. Ask Once, Persist - The mode selection question is asked only when mode is unset; the choice is persisted via spellbook_config_set.
  2. Mode Drives Skill, Not Behavior - Mode selection loads the corresponding skill; mode never alters code output or technical decisions.
  3. Graceful Degradation - If MCP is unavailable, remember the preference in-session without blocking initialization.

Reference procedure for selecting and dispatching session modes during session initialization.

Mode Dispatch Table

Response from spellbook_session_init Action
mode.type: "unset" Ask question below, then call spellbook_config_set(key="session_mode", value="fun"/"tarot"/"none")
mode.type: "fun" + persona/context/undertow Load fun-mode skill, announce persona+context+undertow in greeting
mode.type: "tarot" Load tarot-mode skill, announce roundtable in greeting
mode.type: "none" Proceed normally with standard greeting
MCP unavailable Ask mode question manually, remember preference for session

Mode Selection Question

Ask once when mode is unset:

Research suggests creative modes improve LLM output via "seed-conditioning" (Nagarajan et al., ICML 2025). I can adopt:

  • Fun mode: Random personas each session (dialogue only, never in code)
  • Tarot mode: Ten archetypes collaborate via visible roundtable (Magician, Priestess, Hermit, Fool, Chariot, Justice, Lovers, Hierophant, Emperor, Queen)
  • Off: Standard professional mode

Which do you prefer? (Use /mode fun, /mode tarot, or /mode off anytime to switch)

Procedure

  1. Read mode.type from spellbook_session_init response.
  2. Match against dispatch table above.
  3. If "unset": present the selection question, wait for user answer, then call spellbook_config_set(key="session_mode", value=<chosen>).
  4. If "fun" or "tarot": load the corresponding skill (fun-mode or tarot-mode) and incorporate its output into the session greeting.
  5. If "none" or MCP unavailable: no further action needed for mode.

Expand your agent's capabilities with these related and highly-rated skills.

axiomantic/spellbook

spellbook-auditing

Meta-audit skill for spellbook development. Spawns parallel subagents to factcheck docs, optimize instructions, find token savings, and identify MCP candidates. Produces actionable report.

5 2
Explore
axiomantic/spellbook

documentation-updates

Use after modifying library skills, library commands, or agents to ensure CHANGELOG, README, and docs are updated

5 2
Explore
axiomantic/spellbook

project-encyclopedia

[DEPRECATED] Use project-level AGENTS.md files instead. Previously used for first-session codebase onboarding and persistent glossary creation.

5 2
Explore
axiomantic/spellbook

reviewing-impl-plans

Use when reviewing implementation plans before execution. Triggers: 'is this plan solid', 'review the plan', 'check before I start building', 'anything missing from this plan', 'will this plan work', 'audit the implementation plan'. NOT for: reviewing design documents (use reviewing-design-docs) or creating plans (use writing-plans).

5 2
Explore
axiomantic/spellbook

session-resume

Session resume protocol and session repairs handling. Loaded when spellbook_session_init returns resume_available: true, or when session_init returns a repairs array. Triggers: 'resume', 'continue', 'where were we', session resume, session repairs.

5 2
Explore
axiomantic/spellbook

brainstorming

Use when exploring design approaches, generating ideas, or making architectural decisions. Triggers: 'explore options', 'what are the tradeoffs', 'how should I approach', 'let's think through', 'sketch out an approach', 'I need ideas for', 'how would you structure', 'what are my options'. Also invoked by develop when design decisions are needed.

5 2
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results