CommunityCoding & Developmentgithub.com

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".

Works with✓Claude Code~Codex CLI~Cursor
npx add-skill https://github.com/bytedance/deer-flow/tree/main/skills/public/surprise-me
View original→Browse all skills

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)

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

academic-paper-review

Use this skill when the user requests to review, analyze, critique, or summarize academic papers, research articles, preprints, or scientific publications. Supports comprehensive structured reviews covering methodology assessment, contribution evaluation, literature positioning, and constructive feedback generation. Trigger on queries involving paper URLs, uploaded PDFs, arXiv links, or requests like "review this paper", "analyze this research", "summarize this study", or "write a peer review".

bootstrap

Generate a personalized SOUL.md through a warm, adaptive onboarding conversation. Trigger when the user wants to create, set up, or initialize their AI partner's identity — e.g., "create my SOUL.md", "bootstrap my agent", "set up my AI partner", "define who you are", "let's do onboarding", "personalize this AI", "make you mine", or when a SOUL.md is missing. Also trigger for updates: "update my SOUL.md", "change my AI's personality", "tweak the soul".

chart-visualization

This skill should be used when the user wants to visualize data. It intelligently selects the most suitable chart type from 26 available options, extracts parameters based on detailed specifications, and generates a chart image using a JavaScript script.

claude-to-deerflow

Interact with DeerFlow AI agent platform via its HTTP API. Use this skill when the user wants to send messages or questions to DeerFlow for research/analysis, start a DeerFlow conversation thread, check DeerFlow status or health, list available models/skills/agents in DeerFlow, manage DeerFlow memory, upload files to DeerFlow threads, or delegate complex research tasks to DeerFlow. Also use when the user mentions deerflow, deer flow, or wants to run a deep research task that DeerFlow can handle.

code-documentation

Use this skill when the user requests to generate, create, or improve documentation for code, APIs, libraries, repositories, or software projects. Supports README generation, API reference documentation, inline code comments, architecture documentation, changelog generation, and developer guides. Trigger on requests like "document this code", "create a README", "generate API docs", "write developer guide", or when analyzing codebases for documentation purposes.

consulting-analysis

Use this skill when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial analysis, industry research, competitive intelligence, investment due diligence, or any consulting-grade analytical report. This skill operates in two phases — (1) generating a structured analysis framework with chapter skeleton, data query requirements, and analysis logic, and (2) after data collection by other skills, producing the final consulting-grade report with structured narratives, embedded charts, and strategic insights.

data-analysis

Use this skill when the user uploads Excel (.xlsx/.xls) or CSV files and wants to perform data analysis, generate statistics, create summaries, pivot tables, SQL queries, or any form of structured data exploration. Supports multi-sheet Excel workbooks, aggregation, filtering, joins, and exporting results to CSV/JSON/Markdown.

deep-research

Use this skill instead of WebSearch for ANY question requiring web research. Trigger on queries like "what is X", "explain X", "compare X and Y", "research X", or before content generation tasks. Provides systematic multi-angle research methodology instead of single superficial searches. Use this proactively when the user's question needs online information.

find-skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

github-deep-research

Conduct multi-round deep research on any GitHub Repo. Use when users request comprehensive analysis, timeline reconstruction, competitive analysis, or in-depth investigation of GitHub. Produces structured markdown reports with executive summaries, chronological timelines, metrics analysis, and Mermaid diagrams. Triggers on Github repository URL or open source projects.

image-generation

Use this skill when the user requests to generate, create, imagine, or visualize images including characters, scenes, products, or any visual content. Supports structured prompts and reference images for guided generation.

newsletter-generation

Use this skill when the user requests to generate, create, write, or draft a newsletter, email digest, weekly roundup, industry briefing, or curated content summary. Supports topic-based research, content curation from multiple sources, and professional formatting for email or web distribution. Trigger on requests like "create a newsletter about X", "write a weekly digest", "generate a tech roundup", or "curate news about Y".

podcast-generation

Use this skill when the user requests to generate, create, or produce podcasts from text content. Converts written content into a two-host conversational podcast audio format with natural dialogue.

ppt-generation

Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Creates visually rich slides by generating images for each slide and composing them into a PowerPoint file.

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

systematic-literature-review

Use this skill when the user wants a systematic literature review, survey, or synthesis across multiple academic papers on a topic. Also covers annotated bibliographies and cross-paper comparisons. Searches arXiv and outputs reports in APA, IEEE, or BibTeX format. Not for single-paper tasks — use academic-paper-review for reviewing one paper.

video-generation

Use this skill when the user requests to generate, create, or imagine videos. Supports structured prompts and reference image for guided generation.

web-design-guidelines

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

Related Skills

barongoj3693/nativewright

Control a persistent Chrome browser with CLI commands for AI agents while maintaining login states.

community

Weizhongjin/hatch-evolution-bet

An evolvable replacement for codex skill hatch-pet .

community

code-yeongyu/web-fetch

LLM-neutral skill that fetches a URL to a temp file so agents can pipe the path through rg / jq / awk instead of dumping the whole page into context. Same shape as pi-webfetch / opencode webfetch. Single-file Python 3 stdlib. Works on macOS, Linux, Windows.

community

hryer/crypto-infra-skills

effective skills is claude skills for Software Engineer who works with Cryptocurrency it can be CEX / DEX / Web3.

community

whenrealizing/monopolyfun-agent-skill

MonopolyFun agent skill for Codex, Hermes, and OpenClaw runtime execution.

community

Nbofs8398/claudes-ai-buddies

Host and manage competing AI engines in one platform to test, compare, and deploy multiple AI models efficiently.

community
← More Coding & Development skills