skill Claude Code CX Codex Cursor GitHub Copilot
Open on GitHub
surprise-me — Claude Code skill: what it does, how to install
This skill combines available skills into one unexpected creative deliverable. Use it when you want inspiration or a project without choosing the format yourself.
Install into Claude Code · Skills CLI (Vercel)
All methods and platforms ↓
npx skills add bytedance/deer-flow --skill surprise-me -a claude-codeWhat surprise-me does
The skill checks which skills are available, picks one to three, then combines their work into a single result. That could mean turning research into a slide deck or making an interactive web page. The output is meant to feel like one finished piece, not separate demos.
When no other skills are available, it can create an HTML page about a current news story or build an interactive project. The news option involves searching for a current story, so access to search matters for that route. A brief request is enough to trigger it: ask for a surprise, inspiration, or something interesting.
What it helps with
- find a starting point for a creative project
- combine several skills into one deliverable
- make an interactive HTML project from an open-ended prompt
- turn research into a slide deck
Example prompts for the agent
- Surprise me with something made from my available skills.
- I'm bored. Make an interesting interactive project.
- Create an unexpected piece using the skills you can access.
How to install surprise-me
1Skills CLI (Vercel)
npx skills add bytedance/deer-flow --skill surprise-me -a claude-code2Manually: put the files in place
~/.claude/skills/surprise-me/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/surprise-me/
1Skills CLI (Vercel)
npx skills add bytedance/deer-flow --skill surprise-me -a codex2Manually: put the files in place
.agents/skills/surprise-me/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bytedance/deer-flow --skill surprise-me -a cursor2Manually: put the files in place
.cursor/skills/surprise-me/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bytedance/deer-flow surprise-me2Manually: put the files in place
.github/skills/surprise-me/SKILL.md1Skills CLI (Vercel)
npx skills add bytedance/deer-flow --skill surprise-me -a gemini-cli2Platform CLI
gemini skills install https://github.com/bytedance/deer-flow --path skills/public/surprise-meManually: put the files in place
.devin/skills/surprise-me/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bytedance/deer-flow --skill surprise-me -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set11
The whole set →
ppt-generation Creates PPTX presentations by generating slide visuals and assembling them into PowerPoint decks. Useful when you need a consistent visual deck from a text prompt.
Claude Code CX Codex Cursor +1
5,200installs
video-generation Generates videos via Gemini Veo or MiniMax using structured JSON prompts, optional reference images, and an automated Python script.
Claude Code CX Codex Cursor +1
3,000installs
consulting-analysis This skill plans a research framework, then turns collected material into a structured report. Use it for market, financial, brand, or competitor analysis.
Claude Code CX Codex Cursor +1
3,000installs
image-generation Builds structured JSON prompts and executes a Python script to generate images with optional reference files. Useful for character design and complex scene rendering.
Claude Code CX Codex Cursor +1
2,900installs
deep-research A skill for thorough web research using multi-angle analysis methodology. Use it instead of basic search when you need to understand a topic from all angles before writing content or tackling a complex question.
Claude Code CX Codex Cursor +1
2,800installs
academic-paper-review A skill for automated peer review of academic papers following top-conference standards. Assesses methodology, evaluates novelty, identifies weaknesses, and delivers evidence-based critique.
Claude Code CX Codex Cursor +1
2,700installs
systematic-literature-review A skill to automatically search and synthesize multiple papers by topic from arXiv. Collects research, extracts key findings, and outputs reports in APA, IEEE, or BibTeX format.
Claude Code CX Codex Cursor +1
2,500installs
code-documentation This skill auto-generates README files, API references, architecture docs, and developer guides straight from your codebase. Use it to document projects, libraries, and APIs without manual effort.
Claude Code CX Codex Cursor +1
1,900installs
Similar
cli-hub-meta-skill A skill that gives agents a catalog of professional command-line tools built for AI. Search, install, and run CLIs for video, design, AI, and development without leaving your editor.
Claude Code CX Codex Cursor +1
5,300installs
codex-result-handling
official A skill that ensures Codex results are presented to you properly. Preserves findings, inferences, file paths, line numbers, and severity order. Blocks automatic code fixes after review—you must approve changes first.
Claude Code CX Codex Cursor +1
675installs
cmux-customization Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty.
Claude Code CX Codex Cursor +1
6,600installs
cmux-diagnostics Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report.
Claude Code CX Codex Cursor +1
6,400installs
cloud-sync Syncs your claude-mem database with cmem.ai Pro cloud storage. Checks sync status, manages the connection, and uploads observation narratives to the server.
Claude Code CX Codex Cursor +1
2,100installs
prioritization-frameworks Reference guide to 9 prioritization frameworks: RICE, ICE, Opportunity Score, Kano, MoSCoW and more. Helps you pick the right method, compare approaches, and rank tasks by importance.
Claude Code CX Codex Cursor +1
9,900installs
setup-matt-pocock-skills This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills.
Claude Code
1,052,851installs
to-tickets Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker.
Claude Code
711,230installs
Questions about surprise-me
How do I install surprise-me in Codex?
Run npx skills add bytedance/deer-flow --skill surprise-me -a codex. The skill file is at .agents/skills/surprise-me/SKILL.md.
What does the surprise-me skill do?
It selects one to three available skills and combines them into a single creative deliverable. If no other skills are available, it can make an HTML page based on a news story or an interactive project.
What happens when no other skills are available?
It offers a news-based HTML page, an interactive HTML project, or a personalized artifact based on known user context. The news option searches for a current story.
Source text
SKILL.md · MIT
--- name: surprise-me description: 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". --- # Surprise 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: 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 full SKILL.md body of each selected skill 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)
© bytedance · MIT · bytedance/deer-flow
