mode-creator

Create, install, and verify custom claude-mem observation modes with optional Telegram alerts.

92.8k|8.2k|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/thedotmack/claude-mem --skill mode-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mode-creator
Source: https://github.com/thedotmack/claude-mem/tree/main/plugin/skills/mode-creator
Command: npx skills add https://github.com/thedotmack/claude-mem --skill mode-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Default claude-mem observation modes are tuned for software work, so users in law, architecture, research, or other domains end up with notes that miss the categories they actually search for later. This Skill interviews the user, proposes a domain-specific taxonomy, installs it durably, and proves the active mode appears in startup context.

Core Features & Use Cases

  • Interactive taxonomy design: Conducts a purpose-first interview, then proposes 4–8 observation types and 4–8 concept tags tailored to the user's domain.
  • Validated installation: Merges the override with a parent mode, validates every required prompt field, and writes the mode file atomically under the resolved data directory.
  • Optional Telegram alerts: Securely configures a Telegram bot token via hidden terminal input, validates it with getMe, discovers the chat ID, and merges trigger types and concepts without overwriting existing settings.
  • Restart and verification: Restarts the worker through the verified CLI path and confirms the active mode appears in startup context, falling back to repair if the worker reverts to code mode.
  • Use Case: A law student wants claude-mem to remember case holdings, issue-spotting patterns, professor frameworks, minority rules, and exam traps. This Skill interviews them, proposes a focused remix of the bundled law-study mode, installs it, and verifies the active mode in startup context.

Quick Start

Ask the mode-creator skill to set up a custom claude-mem mode for tracking architecture design decisions, client priorities, and site discoveries, with Telegram alerts for cost-impact concepts.

Frequently Asked Questions about mode-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom claude-mem mode for a non-software domain?

Run the mode-creator skill, answer the purpose-first interview about your work, approve the proposed observation types and concept tags, and the installer writes a validated mode file under the resolved data directory's modes folder.

Can I remix an existing bundled mode instead of writing one from scratch?

Yes. Use an inherited ID such as code--architecture-practice so the installer deep-merges your override with the parent mode. The override must replace code-specific prompt semantics while keeping the stable output protocol intact.

How does Telegram alerting work with custom claude-mem modes?

After approving the taxonomy, run configure-telegram.mjs which collects the BotFather token through hidden terminal input, validates it with getMe, discovers the chat ID via getUpdates, sends a test message, and stores settings with 0600 permissions.

Why does my worker fall back to code mode after installing a custom mode?

The worker reverts to code when the mode file fails validation or lookup. Inspect the worker log for the specific error, repair the mode JSON, and rerun npx claude-mem restart followed by the startup-context verification.

Can I install a custom mode when CLAUDE_MEM_RUNTIME is set to server?

No. Custom modes are supported by the local worker runtime only. If the runtime is server, the workflow stops before mutation because per-user modes cannot be safely installed into a shared server.