---
name: whathappened
description: >-
  Brief what just happened on a topic and map public opinion from X (Twitter) only. Adaptive recency window biased to the freshest coherent story. Soft exception: at most one web lookup for entity resolution. Use when the user runs /whathappened, or asks what happened / what's going on / X or Twitter reaction / public opinion on X about a person, product, launch, or event. Grok Build only (requires native X tools). Neutral analyst tone. No discovery mode in v1.
metadata:
  short-description: "X-only adaptive briefing of events + public opinion"
title: whathappened
canonical_url: https://skilld.dev/gh/kunchenguid/whathappened
last_updated: 2026-11-12T03:31:03.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/failure-modes.md](https://skilld.dev/api/skills-raw/kunchenguid/whathappened/whathappened/references/failure-modes.md), [references/query-patterns.md](https://skilld.dev/api/skills-raw/kunchenguid/whathappened/whathappened/references/query-patterns.md).
>
> If the user asked to install this Skill, run `npx skilld install kunchenguid/whathappened/whathappened`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/whathappened`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/kunchenguid/whathappened/whathappened) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/whathappened`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/whathappened --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/whathappened --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# /whathappened

You are running the **whathappened** skill. Produce a neutral briefing of
**what happened** and **what public X is saying** about a named topic.

This is not generic research. Follow this file top to bottom.

## Host requirement

You need these tools:

- `x_keyword_search`
- `x_semantic_search`
- `x_thread_fetch`
- `x_user_search`

If they are missing, **stop**. Tell the user this skill only works in Grok Build
(or another host with those X tools). Do not fake an X briefing from web search.

## Hard rules

1. **X-first synthesis.** All claims about the event and public opinion come
   from X tool results. Never invent posts, handles, engagement, or quotes.
2. **Soft web exception.** At most **one** web lookup (`web_search` or
   `web_fetch`) **only** to resolve what/who the topic is (official name,
   handle, product identity). Do not use web for opinions, sentiment, or
   "what people think." If you use the web lookup, say so in Gaps.
3. **No discovery.** If the user gives no topic, or asks "what's trending /
   what's hot on X," do **not** invent a feed. Ask for a topic in one short
   question.
4. **No flags in v1.** Ignore or gently ignore flag-like tokens (`--deep`,
   window overrides). Infer window from the pulse (below).
5. **Neutral analyst tone.** No hype voice, no dunking, no "the room is
   screaming." Report camps and debates as observed.
6. **Adaptive window, freshest-first.** Do not default to 30 days. Prefer the
   shortest window that still explains the story.
7. **Opinion is not ground truth.** Frame sentiment as public conversation on
   this X sample.
8. **Citations.** Prefer `@handle` plus post links when available. Use the
   host's inline post citation render when you have post citation IDs from X
   tools. Never invent URLs. Never append a trailing dump of unrelated Sources.

Read `references/query-patterns.md` when building search queries.
Read `references/failure-modes.md` when the sample looks thin, mixed, or noisy.

## Pipeline

### Step 0 - Parse topic

- Require a **named topic** (person, org, product, launch, event, controversy).
- Strip intent modifiers for search entities (`sentiment`, `drama`, `takes`)
  but keep them as synthesis focus if the user asked for them.
- Classify loosely: event | person/org | product/release | debate.

### Step 1 - Optional entity web lookup (0 or 1 call)

If the topic is ambiguous or you lack an obvious official handle/name:

- Make **at most one** web lookup to resolve identity.
- Extract: canonical name, official `@handle` if stated, aliases, event date
  if the page states one.

If the topic is already clear (e.g. `Kimi K3`, `@sama`), skip web.

### Step 2 - X entity grounding

- Use `x_user_search` for likely official or primary accounts when useful.
- Build aliases: exact phrase, alternate spellings, product codes, cashtags.
- Prefer first-party `from:handle` when you have a confident handle.

### Step 3 - Pulse (always first)

Run a **cheap Latest** keyword search with a short `since:` window to measure
velocity. Example windows to try first:

- Breaking candidate: last few hours (`since:YYYY-MM-DD` for today, Latest)
- If almost empty: widen once (yesterday / last 2 days) before committing mode

**Commit a mode and window:**

| Pulse signal | Mode | Default window |
|--------------|------|----------------|
| High volume, rising engagement, clear origin | Breaking | last 1–6 hours (minutes if still exploding) |
| Clear same-day event / launch chatter | Same-day | last 24–48 hours |
| Ongoing debate, moderate velocity | Story | last 3–7 days |
| Sparse posts, mostly references to older news | Background | last 14–30 days; still prefer recent posts |

State the chosen **Window** and **Mode** in the brief. Expand later only if:

- No agreement on what happened
- Missing first-party post from the obvious account
- Debates point at an origin post you have not seen

When ranking, prefer recency over raw likes unless an older post is clearly
the origin everyone quotes or replies to - then fetch that thread.

### Step 4 - Search lattice (parallel)

Use multiple lanes. Cap total X tool calls roughly **8–14** for a normal run.

| Lane | Tool | Goal |
|------|------|------|
| Top | `x_keyword_search` mode=`Top` | High-engagement consensus |
| Latest | `x_keyword_search` mode=`Latest` + time operators | Fresh narrative |
| Semantic | `x_semantic_search` | Paraphrases and adjacent framing |
| First-party | keyword `from:handle` when known | Official statement |
| Debate | controversy / quote / counter-claim queries | Disagreement surface |

Use advanced operators from `references/query-patterns.md`. Always keep the
primary entity in the query. Drop off-entity viral noise.

### Step 5 - Thread enrichment

`x_thread_fetch` the **3–8** highest-signal posts, prioritizing:

1. Origin / announcement
2. Official first-party
3. Highest-engagement summary take
4. Strongest steelman and strongest criticism
5. Posts that define a camp split

### Step 6 - Rank and cluster (in head, lightweight)

Rough score:

```text
score = engagement × freshness_weight × authority_weight × on_entity
```

- **On-entity:** must clearly be about the primary topic (or hard alias).
- **Authority (soft):** official accounts, domain experts, primary reporters -
  never a hard allowlist; do not over-weight bluechecks alone.
- **Clusters:** merge posts that make the same claim into one camp bullet.

Discard engagement bait that fails entity grounding.

### Step 7 - Synthesize

Emit the brief using the template below. Do not dump raw ranked lists.
Include **at least 2–3 short attributed quotes** from real posts when the
sample has usable text.

If the sample is thin, say so. Prefer honest uncertainty over fake consensus.

## Output template

Use this structure. Keep headings. No extra blog-style sections.

```markdown
# /whathappened: {topic}

**Window:** {human window} · mode {Breaking|Same-day|Story|Background} · as of {UTC or local stamp}
**X sample:** ~{N} posts · Top + Latest + {K} threads · confidence {high|medium|thin}
**Entity resolve:** {none | one web lookup: one-line what it was for}

## What happened
2–5 sentences. Prefer first-party and origin posts. Stick to what X supports.

## Where the conversation is
- Dominant frame
- Secondary frames
- Who is loud (camps / account types), not "people in general"

## Public opinion map
| Camp | Share (rough) | Core claim | Representative voices |
|------|---------------|------------|------------------------|
| … | ~X% | … | @a, @b |

Label shares as qualitative judgment from this sample, not polling.

## The live debates
1. **{title}** - Side A vs Side B; stakes in one line; best evidence posts
2. …

## Notable posts (receipts)
- [@handle](url or status link if known) - why it matters (role: origin / official / steelman / critique / meme)
- … (5–10 max)

## Gaps / caveats
- Thin sample, missing official voice, language bias, bot/noise risk, web resolve used, etc.
- What would change this read if true
```

### Formatting notes

- Use plain hyphens `-`, not em dashes.
- Neutral wording: "many posts claim", "a common critique is", not "everyone knows".
- Rough camp percentages must be marked as rough sample judgment.
- If confidence is thin, shrink the opinion map and expand Gaps.
- End after Gaps. No trailing invitation spam unless the user asked follow-ups.

## Pre-flight checklist (before first tool call)

- [ ] Topic present (else ask)
- [ ] X tools available (else refuse)
- [ ] Web budget remaining: 0 or 1 resolve-only
- [ ] No discovery request

## Post-synthesis checklist (before send)

- [ ] Window + mode stated
- [ ] Every quoted line attributable to a fetched post
- [ ] No web-derived "sentiment"
- [ ] Camps grounded in multiple posts when confidence is high
- [ ] Receipts are real and on-entity
- [ ] Gaps honest about sample limits
