Add Session Mode to HTML Effectiveness skill

[SunnyDevendranadh]

Summary

Introduces Session Mode to the HTML Effectiveness skill, making it sticky per-session rather than requiring re-invocation on every turn. Once activated, the skill applies to all subsequent artifacts in that session until explicitly deactivated or the session ends.

Key Changes

• New Claude Code skill format (.claude/skills/html-effectiveness/SKILL.md): Implements the skill as a reusable, installable session skill for Claude Code with built-in activation/deactivation lifecycle management.

• Session Mode specification (droids/html-effectiveness.md):

  • Defined activation triggers (slash commands: /html-effectiveness, /html, /html-on, /html-mode; phrases: "html mode on", "use html mode", etc.)
  • Defined deactivation triggers (/html-off, "html mode off", etc.)
  • Added .html-mode file marker for auto-activation at session start
  • Clarified what gets produced as HTML (substantial artifacts) vs. plain text (one-liners, tool status, errors)
  • Introduced companion-file rule: reserved .md files (README, CLAUDE, AGENTS, etc.) stay canonical markdown and gain a sibling .html for richer browsing
  • Added output-location convention (./artifacts/ for free-standing, sibling for companions)
  • Added session-mode self-check before responding

• Updated harness setup guides (docs/harness-setup.md):

  • Added universal triggers table (activation/deactivation across all harnesses)
  • Expanded Claude Code section with recommended skill installation path and alternative CLAUDE.md approach
  • Updated all harness sections (Codex, Cursor, Windsurf, Copilot, Aider, Continue, Replit, LM Studio) to reference Session Mode, sticky behavior, and companion-file rule
  • Clarified that short answers and tool status remain plain text even when mode is active

• Updated README.md:

  • Added Session Mode overview and quick-reference activation/deactivation tables
  • Promoted Claude Code skill installation as Option 1 (recommended)
  • Reordered quick-start options to reflect new skill-first approach
  • Added "Where artifacts land" and "What gets produced as HTML" sections for clarity

Notable Implementation Details

• Sticky behavior: Once activated, the mode persists for the entire session without requiring the user to re-invoke it per turn.
• Confirmation messages: Activation produces a single plain-text line (not an HTML splash screen); deactivation confirms return to default markdown.
• Companion-file rule: Balances harness compatibility (canonical .md files stay valid) with richness (companion .html for browsing and interaction).
• Plain-text carve-outs: Explicitly lists what should NOT be wrapped in HTML (one-liners, errors, commit messages) to avoid over-producing artifacts.
• File marker auto-activation: Presence of .html-mode at repo root enables the mode at session start without explicit user invocation.

https://claude.ai/code/session_01Ctw24zUjKXL1BxM4NsvAV5