Skip to content

feat: add xquik community skill#2

Open
kriptoburak wants to merge 5 commits into
framerslab:masterfrom
kriptoburak:codex/add-xquik-x-data-skill
Open

feat: add xquik community skill#2
kriptoburak wants to merge 5 commits into
framerslab:masterfrom
kriptoburak:codex/add-xquik-x-data-skill

Conversation

@kriptoburak

@kriptoburak kriptoburak commented Jun 12, 2026

Copy link
Copy Markdown

What changed

  • Added registry/community/xquik-x-data/SKILL.md.
  • Scoped the skill to X/Twitter search, profile and post reads, extractions, MCP setup, and signed webhooks through Xquik.
  • Included AgentOS community frontmatter, examples, and safety constraints.

Validation

  • npm run validate registry/community/xquik-x-data/SKILL.md passed.
  • npm run typecheck passed.
  • npm run build passed.
  • git diff --check passed.
  • Source links returned 200.
  • Duplicate gate: no Xquik, x-twitter-scraper, x-developer, or xquik.com entries, PRs, or issues found in this repo.

Notes

  • npm run validate without a path still fails on existing curated skills unrelated to this PR. The new community skill passes its targeted validator.

Summary by Sourcery

Add a new community skill definition for working with X/Twitter data via the Xquik MCP and API.

New Features:

  • Introduce the xquik-x-data community skill for searching and reading X/Twitter data, running extractions, and handling signed webhooks via Xquik.

Documentation:

  • Document setup steps, typical workflows, usage examples, and safety constraints for the xquik-x-data community skill.

Summary by CodeRabbit

  • New Features

    • Registered new "xquik-x-data" community skill enabling data search, reads, and extractions with webhook event support. Requires API key authentication and MCP server/REST client setup.
  • Documentation

    • Added detailed skill documentation covering configuration steps, supported workflows with example use cases, tool integration mappings, and security guidelines for handling data safely.

@sourcery-ai

sourcery-ai Bot commented Jun 12, 2026

Copy link
Copy Markdown

Reviewer's Guide

Adds a new community skill definition for the Xquik X/Twitter data integration, including AgentOS metadata, setup guidance, usage workflows, examples, and safety constraints for using Xquik MCP and API securely.

Flow diagram for using the Xquik X Data skill

flowchart TD
  U[User request about X/Twitter data]
  A[Agent selects xquik-x-data skill]
  S{API key available in secure store?}
  K[Ask user to provide scoped Xquik API key]
  C[Store key as XQUIK_API_KEY or equivalent]
  M{Client supports MCP tools?}
  MCP[Use xquikMcp for search, reads, extractions]
  REST[Use xquikApi REST endpoints/webhooks]
  R[Summarize results and respect constraints]

  U --> A --> S
  S -- No --> K --> C --> M
  S -- Yes --> M

  M -- Yes --> MCP --> R
  M -- No --> REST --> R
Loading

File-Level Changes

Change Details Files
Introduce a new community skill specification for Xquik-based X/Twitter data access and workflows.
  • Define skill frontmatter with name, version, description, author, namespace, category, tags, required secrets, required tools, and AgentOS-specific metadata.
  • Document when and how to use the skill with Xquik MCP and REST API, including credential setup and preference between MCP and REST flows.
  • Enumerate supported workflows such as search, profile and timeline reads, extraction jobs, and signed webhook configuration, with emphasis on summarizing large result sets.
  • Provide natural-language examples to guide prompt usage of the skill for common X/Twitter data tasks.
  • Spell out safety and privacy constraints around credentials, untrusted content handling, write actions, and verification against Xquik documentation.
registry/community/xquik-x-data/SKILL.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@coderabbitai

coderabbitai Bot commented Jun 12, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c8bc2741-900e-4437-bcd0-5c7b6c8733db

📥 Commits

Reviewing files that changed from the base of the PR and between 522adb3 and 50eb1b7.

📒 Files selected for processing (2)
  • registry.json
  • registry/community/xquik-x-data/SKILL.md

📝 Walkthrough

Walkthrough

A new community skill, xquik-x-data, is registered in the skill registry. The registry metadata is updated with the current timestamp, the community category is populated with the skill identifier, and a new unverified community skill entry is added with configuration for required API credentials. Complete skill documentation defines setup instructions, MCP/REST tool mappings, supported workflows, example usage patterns, and safety constraints for handling untrusted X/Twitter data and webhook delivery.

Changes

Xquik X-Data Skill Registry Entry

Layer / File(s) Summary
Registry entry and catalog metadata
registry.json
Registry metadata timestamp is updated, the community category is populated with xquik-x-data, and a new skill object is added with unverified status, required xquik.apiKey secret, and path to the community skill directory. Registry stats are incremented to count 89 total skills and 1 community skill.
Skill documentation and constraints
registry/community/xquik-x-data/SKILL.md
Complete SKILL.md file documents xquik-x-data v1.0.0, including metadata, setup instructions for API key and MCP server, tool mapping between MCP and REST endpoints, supported workflows (search, reads, extractions, webhooks), example prompts for searching posts and profiles, and explicit operational constraints about data access, secret handling, untrusted content, write confirmation, and HTTPS webhook enforcement.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 A registry hops with fresh xquik delight,
Community skills bloom in the web twilight!
From tweets to extractions, data flows free,
Yet secrets stay safe where they ought to be. ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: add xquik community skill' directly and clearly describes the main change: adding a new community skill for xquik to the registry, which matches the changeset contents perfectly.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've left some high level feedback:

  • Consider clarifying how xquikMcp and xquikApi map to concrete tool or MCP server names (e.g., expected tool identifiers or MCP URI), so integrators know exactly what to configure.
  • It may be useful to explicitly state that the skill should only be used with public or appropriately consented X/Twitter data, and that the assistant should avoid attempting to access private/protected content beyond what the API legitimately exposes.
  • In the constraints/setup sections, you might want to add guidance that webhook endpoints must use HTTPS and that signing secrets and callback URLs should be treated as secrets stored in the platform’s secure store, mirroring the API key handling.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- Consider clarifying how `xquikMcp` and `xquikApi` map to concrete tool or MCP server names (e.g., expected tool identifiers or MCP URI), so integrators know exactly what to configure.
- It may be useful to explicitly state that the skill should only be used with public or appropriately consented X/Twitter data, and that the assistant should avoid attempting to access private/protected content beyond what the API legitimately exposes.
- In the constraints/setup sections, you might want to add guidance that webhook endpoints must use HTTPS and that signing secrets and callback URLs should be treated as secrets stored in the platform’s secure store, mirroring the API key handling.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: be8bddce34

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -0,0 +1,51 @@
---
name: xquik-x-data

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Regenerate registry index for the new skill

Adding this SKILL.md without also updating the generated registry.json leaves the package's exported catalog unchanged: in this commit registry.json still has skills.community: [] and communityCount: 0. Consumers that import @framers/agentos-skills or ./registry.json will not discover xquik-x-data even though the file is shipped, so please regenerate and commit the registry after adding the skill.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 3a32b63. registry.json now includes xquik-x-data under categories.community, adds the skills.community entry, updates stats to 89 total and 1 community skill, and refreshes the registry timestamp.

Validation rerun:

  • npm run validate registry/community/xquik-x-data/SKILL.md
  • registry JSON assertion
  • npm run typecheck
  • npm run build
  • git diff --check

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant