diff --git a/docs/README.skills.md b/docs/README.skills.md index aa492a833..199978ae1 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -436,4 +436,5 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [workiq-copilot](../skills/workiq-copilot/SKILL.md)
`gh skills install github/awesome-copilot workiq-copilot` | Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations. | None | | [workshop-create](../skills/workshop-create/SKILL.md)
`gh skills install github/awesome-copilot workshop-create` | Create a new workshop or use an existing directory as one. Handles two paths: (A) use an existing local directory the operator points at, or (B) create a new private GitHub repo in the signed-in account. Never creates a repo inside another repo. | None | | [write-coding-standards-from-file](../skills/write-coding-standards-from-file/SKILL.md)
`gh skills install github/awesome-copilot write-coding-standards-from-file` | Write a coding standards document for a project using the coding styles from the file(s) and/or folder(s) passed as arguments in the prompt. | None | +| [x-research](../skills/x-research/SKILL.md)
`gh skills install github/awesome-copilot x-research` | Search and inspect current public X/Twitter posts, trends, profiles, profile posts, media, and replies through AgentBody's fixed REST contract. Use this skill when the user asks to search X or Twitter, monitor a topic or account, inspect a post, track trends, or gather current X evidence. | None | | [x-twitter-scraper](../skills/x-twitter-scraper/SKILL.md)
`gh skills install github/awesome-copilot x-twitter-scraper` | Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation. | None | diff --git a/skills/x-research/SKILL.md b/skills/x-research/SKILL.md new file mode 100644 index 000000000..f96bd1260 --- /dev/null +++ b/skills/x-research/SKILL.md @@ -0,0 +1,28 @@ +--- +name: x-research +description: | + Search and inspect current public X/Twitter posts, trends, profiles, profile posts, media, and replies through AgentBody's fixed REST contract. Use this skill when the user asks to search X or Twitter, monitor a topic or account, inspect a post, track trends, or gather current X evidence. +--- + +# X Research + +Read-only X/Twitter research through AgentBody's REST API. + +## When to Use + +- Search public X posts +- Read current trends +- Inspect a post or profile +- Read profile posts, media, or post replies + +## Setup + +Configure `AGENTBODY_API_KEY` once using the AgentBody Agent Quickstart. Run the bundled client: + +```bash +python3 scripts/x_client.py search --query "AI agents" +python3 scripts/x_client.py trending --country US +python3 scripts/x_client.py profile --username OpenAI +``` + +This skill is read-only. Posting, OAuth, likes, follows, and account management are out of scope. \ No newline at end of file