# Surprise Me

> Create a delightful, unexpected "wow" experience for the user by dynamically discovering and creatively combining other enabled skills. Triggers when the user says "surprise me" or any request expressing a desire for an unexpected creative showcase. Also triggers when the user is bored, wants inspiration, or asks for "something interesting".

- Skill: `citrus-bit/surprise-me` (Agent Skill)
- Install (CLI): `npx skillmds@latest add citrus-bit/surprise-me`
- Raw SKILL.md: https://api.skillmd.com/api/skills/citrus-bit/surprise-me/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: citrus-bit (https://skillmd.com/u/citrus-bit)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/citrus-bit/surprise-me

---


# Surprise Me

Deliver an unexpected, delightful experience by dynamically discovering available skills and combining them creatively.

## Workflow

### Step 1: Discover Available Skills

Review the skill names and descriptions already listed in `<available_skills>`. Do not read every skill body. Pick the most relevant candidates from metadata first.

### Step 2: Plan the Surprise

Select **1 to 3** skills and design a creative mashup. The goal is a single cohesive deliverable, not separate demos.

**Creative combination principles:**
- Juxtapose skills in unexpected ways (e.g., a presentation about algorithmic art, a research report turned into a slide deck, a styled doc with canvas-designed illustrations)
- Incorporate the user's known interests/context from memory if available
- Prioritize visual impact and emotional delight over information density
- The output should feel like a gift — polished, surprising, and fun

**Theme ideas (pick or remix):**
- Something tied to today's date, season, or trending news
- A mini creative project the user never asked for but would love
- A playful "what if" concept
- An aesthetic artifact combining data + design
- A fun interactive HTML/React experience

### Step 3: Fallback — No Other Skills Available

If no other skills are discovered (only surprise-me exists), use one of these fallbacks:

1. **News-based surprise**: Search today's news for a fascinating story, then create a beautifully designed HTML artifact presenting it in a visually striking way
2. **Interactive HTML experience**: Build a creative single-page web experience — generative art, a mini-game, a visual poem, an animated infographic, or an interactive story
3. **Personalized artifact**: Use known user context to create something personal and delightful

### Step 4: Execute

1. Read the SKILL.md body only for the 1 to 3 selected skills
2. Follow each skill's instructions for technical execution
3. Combine outputs into one cohesive deliverable
4. Present the result with minimal preamble — let the work speak for itself

### Step 5: Reveal

Present the surprise with minimal spoilers. A short teaser line, then the artifact.

- **Good reveal:** "I made you something ✨" + [the artifact]
- **Bad reveal:** "I decided to combine the pptx skill with the canvas-design skill to create a presentation about..." (kills the surprise)