# Mochi Tips

Feature tips catalog for new users.

- Repository: https://github.com/kirodotdev/KiroCrew (4711 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kirodotdev/KiroCrew --skill mochi-tips -g -a claude-code -y`
Codex: `npx skills add kirodotdev/KiroCrew --skill mochi-tips -g -a codex -y`
Cursor: `npx skills add kirodotdev/KiroCrew --skill mochi-tips -g -a cursor -y`
Gemini CLI: `npx skills add kirodotdev/KiroCrew --skill mochi-tips -g -a gemini-cli -y`

## Description

Feature tips catalog for new users. Plan skill loads this to pick a tip during the first week.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Mochi Feature Tips

These tips are shown to new users during the first week of companionship. The plan skill picks one tip per plan cycle and schedules it as a notify task.

Check `planner_notes.skipped_tips` for tips already shown, pick one that hasn't been used yet. After scheduling a tip, add its id to `skipped_tips` so it won't repeat.

**New to Mochi, advertise the shortcuts first.** A brand-new user does not know Mochi has keyboard shortcuts, so prioritize the `basics` shortcut tips (`chat-panel`, `screenshot`, `hide-show`) in the earliest plan cycles before moving on to productivity/personalization tips. The values below are the **defaults on macOS**; on Windows/Linux the modifier is `Alt+Shift` instead of `Cmd+Shift`, and the user can rebind all three (chat panel, screenshot, hide-all) in Settings → Shortcuts, so if the user has mentioned a custom binding, advertise theirs rather than the default string.

## Tips

### basics
- **drag-me**: "Try dragging me to a different spot! I'll walk from wherever you put me next time. 🐾"
- **chat-panel**: "Press Cmd+Shift+M to toggle the chat panel, or just click me!"
- **screenshot**: "Press Cmd+Shift+X to take a screenshot, I can see what's on your screen!"
- **hide-show**: "Press Cmd+Shift+H to hide or show me and all my windows."

The rest: https://github.com/kirodotdev/KiroCrew/blob/HEAD/src/kiro_crew/apps/builtins/mochi/agents/skills/mochi-tips/SKILL.md