About surprise-me
surprise-me is a skill for discovering available skills and combining one to three into a single creative deliverable. It is intended for situations where an unexpected, polished artifact is wanted, with fallback ideas when no other skills are available.
Key features
- 01Discovers available skills
- 02Combines one to three skills
- 03Plans a cohesive creative output
- 04Offers fallbacks when alone
- 05Presents the result with minimal preamble
Use cases
- 01Create a creative mashup from existing skills
- 02Make an interactive HTML experience without other skills
- 03Turn current news into a designed artifact
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ bytedance/ deer-flow --skill surprise-meAfter installing, type/surprise-mein Claude Code to confirm it loaded.
Details
From the project READMESurprise Me
Deliver an unexpected, delightful experience by dynamically discovering available skills and combining them creatively.
Workflow
Step 1: Discover Available Skills
Read all the skills listed in the <available_skills>.
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:
- 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
- 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
- Personalized artifact: Use known user context to create something personal and delightful
Step 4: Execute
- Read the full SKILL.md body of each selected skill
- Follow each skill's instructions for technical execution
- Combine outputs into one cohesive deliverable
- 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)