x-research
Use when the task needs live posts from X/Twitter, or when deep-research needs its X pass.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- x-research
- description
- Use when the task needs live posts from X/Twitter, or when deep-research needs its X pass.
- allowed-tools
- [ "Bash(python3 *)", "Bash(grok *)", "Bash(command *)", "Bash(mkdir *)", "Bash(test *)", "Read" ]
- argument-hint
- X search query or topic
02 资源文件 3
- 参考文档agents/openai.yaml98 B
- 脚本scripts/search.py7.9 KB
- 脚本scripts/testdata/concat-text.json425 B
03 SKILL.md 正文
x-research
Search X through authenticated Grok. The ledger cites post URLs.
1. Scope
One QUERY. Optional: @handles (max 20), from_date / to_date (YYYY-MM-DD). Default window: last 30 days.
Done when QUERY is a single string and filters are listed or explicitly none.
2. Run
python3 "$HOME/.cursor/skills/x-research/scripts/search.py" \
--slug "<slug>" --query "<QUERY>" \
--out ".research/<slug>/x-research"
Add --handle @foo (repeat), --from YYYY-MM-DD, --to YYYY-MM-DD when scoped.
The script preflights grok + ~/.grok/auth.json, writes raw.json + posts.json. On auth miss it prints the exact fix and exits 1 — tell the user that line.
Done when posts.json has a posts array. Empty array requires a non-empty gaps string naming what X did not return.
3. Ledger
Each kept row is url + handle + quote (optional posted_at, engagement). Engagement is salience. Cite the post URL.
Done when every kept claim maps to an https://x.com/... or https://twitter.com/... URL.
4. Deliver
Standalone: short summary plus [@handle](url) — quote for every kept post.
From deep-research: leave artifacts in --out and return.
Done when that shape is on screen, or the caller has posts.json.
04 同仓库更多 Skills
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
wait-what
Stop. That last message did not land — re-pitch it.
ponytail
Lazy senior dev mode for any coding task (write, refactor, fix, review): YAGNI, stdlib first, no unrequested abstractions. Not for non-coding requests.
i-have-adhd
Shape output for a reader with ADHD. Use this skill whenever responding to ANY user message including coding tasks, debugging, explanations, planning, and casual conversation. Output should lead with concrete next actions, number multi-step work, externalize state across turns, suppress tangents, give specific time estimates, and make wins visible. Trigger even on casual messages and even when the user did not explicitly ask for brevity.
slop
Answer an empirical question, or explore/test something about real code, by building and running throwaway code in ~/slop/ — harnesses, lint rules, load tests, ports, API probes. Never merged. Use whenever disposable code would answer, explore, or test something faster or more reliably than reasoning about it.
research
Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.