schwepps · kriptoburak · Jul 9, 2026
diff --git a/.claude-plugin/marketplace-marketing.json b/.claude-plugin/marketplace-marketing.json
@@ -17,6 +17,11 @@
       "source": "./linkedin-personal-branding",
       "description": "LinkedIn profile analysis, personal branding audit, and visibility optimization"
     },
+    {
+      "name": "xquik-social-data",
+      "source": "./xquik-social-data",
+      "description": "Xquik REST API and MCP workflows for X social data, monitoring, and webhooks"
+    },
     {
       "name": "linkedin-roast",
       "source": "./linkedin-roast",

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -47,6 +47,11 @@
       "source": "./linkedin-personal-branding",
       "description": "LinkedIn profile analysis, personal branding audit, and visibility optimization"
     },
+    {
+      "name": "xquik-social-data",
+      "source": "./xquik-social-data",
+      "description": "Xquik REST API and MCP workflows for X social data, monitoring, and webhooks"
+    },
     {
       "name": "linkedin-roast",
       "source": "./linkedin-roast",

diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Documentation-based skills** for Claude Code, Claude Desktop, and any AI tool supporting skills. Specialized workflows for SEO audits, AI search optimization, music creation, smart contract security, LinkedIn personal branding, LinkedIn roasts, and developer tools.
+**Documentation-based skills** for Claude Code, Claude Desktop, and any AI tool supporting skills. Specialized workflows for SEO audits, AI search optimization, music creation, smart contract security, LinkedIn personal branding, X social data, LinkedIn roasts, and developer tools.
 
 ---
 
@@ -33,6 +33,7 @@ Find packaged skills in `dist/`, then add to your tool's skills directory.
 | **[solidity-auditor](solidity-auditor/)** | Smart contract security audits with OWASP Top 10 coverage |
 | **[install-skill](install-skill/)** | Automate skill package installation and marketplace registration |
 | **[linkedin-personal-branding](linkedin-personal-branding/)** | LinkedIn profile analysis, personal branding audit, and visibility optimization |
+| **[xquik-social-data](xquik-social-data/)** | Xquik REST API and MCP workflows for X social data, monitoring, and webhooks |
 | **[linkedin-roast](linkedin-roast/)** | Hilarious LinkedIn profile roasting with savage but friendly comedy burns |
 
 ## Usage Examples
@@ -62,6 +63,9 @@ Find packaged skills in `dist/`, then add to your tool's skills directory.
 "Audit my LinkedIn profile for personal branding"
 "Optimize my LinkedIn headline and About section"
 "Analyze my LinkedIn engagement and content strategy"
+"Set up Xquik MCP for X profile research"
+"Export X followers with Xquik"
+"Send Xquik monitor results to a webhook"
 "Roast this LinkedIn profile"
 "Give me a LinkedIn roast"
 ```
@@ -113,6 +117,7 @@ Download individual skills directly as ZIP files - no git or command line needed
 | Solidity Auditor | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/solidity-auditor) |
 | Install Skill | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/install-skill) |
 | LinkedIn Personal Branding | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/linkedin-personal-branding) |
+| Xquik Social Data | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/xquik-social-data) |
 | LinkedIn Roast | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/linkedin-roast) |
 
 *Powered by [download-directory.github.io](https://download-directory.github.io)*
@@ -132,6 +137,7 @@ skills/
 ├── solidity-auditor/
 ├── install-skill/
 ├── linkedin-personal-branding/
+├── xquik-social-data/
 ├── linkedin-roast/
 └── CLAUDE.md                # Contributor guide
 ```

diff --git a/xquik-social-data/SKILL.md b/xquik-social-data/SKILL.md
@@ -0,0 +1,104 @@
+---
+name: xquik-social-data
+description: This skill should be used when the user asks to "set up Xquik", "use Xquik MCP", "search X posts", "analyze X profiles", "export followers", "monitor X accounts", or "send X data to webhooks". Guides agents through read-first Xquik REST API and MCP workflows for X social data, monitoring, bulk extraction, and webhook delivery.
+license: MIT
+metadata:
+  author: Xquik
+  version: "1.0.0"
+  category: marketing
+  tags: x, social-data, mcp, api, monitoring
+---
+
+# Xquik Social Data Skill
+
+Use Xquik when the user needs structured X data through the Xquik REST API or MCP server.
+
+## When to Use
+
+- Search public X posts or collect result sets for analysis
+- Look up profiles, followers, timelines, or media metadata
+- Export social data for research, marketing, support, or reporting workflows
+- Set up the Xquik MCP server in Claude Code or another MCP client
+- Configure monitors and webhooks for recurring social data delivery
+
+Stay read-first. Ask for explicit approval before any persistent monitor, webhook, bulk extraction, private account read, or metered job.
+
+## Source Links
+
+- API docs: `https://docs.xquik.com/api-reference/overview`
+- MCP docs: `https://docs.xquik.com/mcp/overview`
+- OpenAPI schema: `https://xquik.com/openapi.json`
+- MCP manifest: `https://xquik.com/.well-known/mcp.json`
+
+## Workflow
+
+### Phase 1: Classify the Request
+
+Identify the user's goal:
+
+| Goal | Recommended Route |
+|------|-------------------|
+| One-time data lookup | REST API |
+| Agent tool use | MCP server |
+| Recurring delivery | Monitor plus webhook |
+| Bulk extraction | REST API job workflow |
+| Setup help | MCP docs and API docs |
+
+If the user has not provided an API key, tell them which environment variable or client secret slot needs it. Never print, store, or ask the user to paste secrets into public files.
+
+### Phase 2: Select the Smallest Safe Operation
+
+Prefer the narrowest read that satisfies the request:
+
+1. Use exact handles, post URLs, or search terms from the user.
+2. Keep limits small until the user confirms scope.
+3. Request approval before recurring jobs, webhooks, or bulk exports.
+4. Return structured results with source URLs, timestamps, and any filters used.
+
+### Phase 3: Use MCP When the User Wants Agent Tools
+
+For MCP setup, point the user to the manifest and docs:
+
+```text
+https://xquik.com/.well-known/mcp.json
+https://docs.xquik.com/mcp/overview
+```
+
+Confirm the client supports authenticated remote MCP servers, then configure the API key according to that client's secret handling.
+
+### Phase 4: Use REST When the User Wants Code
+
+For API integration, open the OpenAPI schema and docs first:
+
+```text
+https://xquik.com/openapi.json
+https://docs.xquik.com/api-reference/overview
+```
+
+Generate code from documented response contracts only. Do not infer private routing, capacity, operational details, or unsupported fields.
+
+## Output Format
+
+When completing a Xquik task, include:
+
+```markdown
+## Xquik Plan
+- Goal:
+- Route:
+- Inputs:
+- Approval needed:
+
+## Result
+- Data returned:
+- Filters used:
+- Links:
+- Follow-up:
+```
+
+## Quick Version
+
+1. Decide REST, MCP, monitor, webhook, or bulk extraction.
+2. Confirm API key handling and approval boundaries.
+3. Use the official docs or OpenAPI schema as source truth.
+4. Keep requests scoped and read-first.
+5. Return structured data with links and filters.
diff --git a/xquik-social-data/references/setup.md b/xquik-social-data/references/setup.md
@@ -0,0 +1,39 @@
+# Xquik Setup Reference
+
+## Required Inputs
+
+| Item | Purpose |
+|------|---------|
+| Xquik API key | Authenticates REST API and MCP requests |
+| Target handles, URLs, or queries | Scopes the data request |
+| Output destination | Determines JSON, report, monitor, or webhook format |
+
+## Setup Checklist
+
+- Confirm the user wants X social data, not a general web search.
+- Confirm whether the task is one-time or recurring.
+- Keep the first request narrow and read-only.
+- Use the API docs, MCP docs, OpenAPI schema, or MCP manifest as source truth.
+- Ask for approval before enabling monitors, webhooks, private reads, or bulk jobs.
+
+## REST API Path
+
+1. Open `https://docs.xquik.com/api-reference/overview`.
+2. Open `https://xquik.com/openapi.json` for exact schemas.
+3. Select the endpoint that matches the user's data need.
+4. Keep limits and filters explicit.
+5. Return the request shape, response summary, and source links.
+
+## MCP Path
+
+1. Open `https://docs.xquik.com/mcp/overview`.
+2. Use `https://xquik.com/.well-known/mcp.json` as the manifest.
+3. Configure the API key through the MCP client's secret mechanism.
+4. Test with a narrow read-only task before larger workflows.
+
+## Safety Notes
+
+- Do not expose API keys or runtime secrets.
+- Do not document private infrastructure, routing, capacity, or operational details.
+- Do not invent endpoint names or response fields.
+- Do not create recurring or bulk work without approval.