Skip to content

feat(xquik): add research plugin and metadata guards#81

Open
kriptoburak wants to merge 4 commits into
duyet:masterfrom
kriptoburak:codex/add-xquik-plugin
Open

feat(xquik): add research plugin and metadata guards#81
kriptoburak wants to merge 4 commits into
duyet:masterfrom
kriptoburak:codex/add-xquik-plugin

Conversation

@kriptoburak

@kriptoburak kriptoburak commented Jul 10, 2026

Copy link
Copy Markdown

Summary

  • Add Xquik as an installable Claude Code and Codex plugin with synchronized manifests and marketplace entries.
  • Configure the remote HTTP MCP server through the environment-only XQUIK_API_KEY header.
  • Add a source-backed X research skill, client instructions, installation documentation, and an MIT license.

Independent Repository Improvements

  • Correct the stale README badge and root metadata to the actual 24 registered plugins.
  • Remove the nonexistent v1.0.0 release link while preserving the changelog and issue links.
  • Extend scripts/validate-plugins.sh to enforce marketplace-to-manifest version parity, metadata.totalPlugins, and the README badge count.

Review Feedback

  • Resolved Gemini's totalPlugins request and added a regression guard.
  • Synchronized the Codex manifest fields requested by CodeRabbit.
  • Replied to both review threads with exact commit and validation evidence.
  • CodeRabbit confirmed its concern is addressed and approved the current head.
  • Sourcery reported no issues.

Validation

  • bash scripts/validate-plugins.sh with 51 checks and 0 failures
  • bash -n scripts/validate-plugins.sh
  • shellcheck scripts/validate-plugins.sh
  • claude plugin validate xquik
  • Exact Claude and Codex metadata-parity assertion
  • jq empty on every changed JSON file
  • Root and Xquik README link checks with local anchor exclusions
  • Exact plugin-directory, marketplace-total, and README-badge parity checks
  • git diff --check
  • Green CodeRabbit, GitGuardian, and Socket checks on the current head

Disclosure

I am affiliated with Xquik. The validator and broken-link improvements are independent repository fixes.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

@sourcery-ai

sourcery-ai Bot commented Jul 10, 2026

Copy link
Copy Markdown

Reviewer's Guide

Adds the Xquik plugin as a source-backed X research skill and MCP server integration for both Claude Code and Codex, updates documentation and marketplace manifests, wires configuration via an environment API key, and corrects the plugin count badge.

File-Level Changes

Change Details Files
Introduce the Xquik X research skill with a structured, safety-focused workflow and output format.
  • Create SKILL.md describing how to use the Xquik MCP server for public X research.
  • Define a step-by-step research workflow including query planning, pagination, normalization, deduplication, and evidence vs. inference separation.
  • Specify output structure (scope, findings, counter-signals, source index, coverage notes) and strict constraints against fabrication.
  • Establish read-only defaults and an explicit confirmation protocol before any write action.
xquik/skills/xquik-x-research/SKILL.md
Document Xquik plugin installation, configuration, usage, safety guarantees, and licensing for the new integration.
  • Add README describing Xquik, installation steps for Claude Code and Codex, and marketplace usage.
  • Explain configuration via XQUIK_API_KEY and MCP header behavior, referencing external Xquik docs.
  • Detail expected usage patterns, research behavior, and safety rules around untrusted evidence and write actions.
  • Declare semantic versioning policy and include MIT license notice.
xquik/README.md
xquik/LICENSE
Provide Claude-specific instructions for using the Xquik skill and enforcing security and provenance rules.
  • Create CLAUDE.md that directs clients to use the Xquik research skill for public X analysis.
  • Reinforce requirements to inspect MCP tool schemas before use and never expose XQUIK_API_KEY.
  • Mandate preservation of source IDs, URLs, timestamps, query provenance, and coverage bounds.
  • Clarify that research is read-only unless explicitly requested and requires confirmation before writes.
xquik/CLAUDE.md
Register the Xquik plugin across marketplace manifests so it is installable in Claude Code and Codex.
  • Add Xquik entries to shared marketplace manifests for agents and Claude plugins.
  • Ensure the root marketplace manifest includes Xquik metadata aligned with other plugins.
  • Provide per-client plugin.json definitions for Claude and Codex under the xquik directory.
  • Add MCP client configuration (.mcp.json) to point at the remote Xquik MCP server and pass XQUIK_API_KEY via header.
.agents/plugins/marketplace.json
.claude-plugin/marketplace.json
marketplace.json
xquik/.claude-plugin/plugin.json
xquik/.codex-plugin/plugin.json
xquik/.mcp.json
Update top-level documentation to reflect the new plugin and correct the plugin-count badge.
  • Change the README plugins badge count from 14 to 24 to match the current number of registered plugins.
  • Add Xquik to the plugins-at-a-glance table as a Skill with a brief description of its research capabilities.
  • Introduce a new Xquik section under Skills explaining components (skill and MCP server) and a concise feature summary.
  • Preserve formatting and anchors for consistent documentation navigation.
README.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 Jul 10, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds the Xquik research plugin, registers it across marketplace catalogs, configures its remote MCP connection, defines research and safety instructions, strengthens marketplace validation, and updates repository and plugin documentation.

Changes

Xquik plugin integration

Layer / File(s) Summary
Marketplace registration and consistency validation
.agents/plugins/marketplace.json, .claude-plugin/marketplace.json, marketplace.json, xquik/.claude-plugin/plugin.json, xquik/.codex-plugin/plugin.json, scripts/validate-plugins.sh
Registers Xquik in marketplace indexes, adds Claude and Codex manifests, updates marketplace metadata, and validates plugin versions, directory counts, and README badge counts.
MCP connection and research workflow
xquik/.mcp.json, xquik/CLAUDE.md, xquik/skills/.../SKILL.md
Configures the authenticated HTTP MCP server and defines schema inspection, evidence handling, pagination, provenance, read-only behavior, and write-confirmation rules.
Plugin documentation and release metadata
README.md, xquik/README.md, xquik/LICENSE
Documents Xquik in the repository and plugin README files and adds its MIT license and trademark notices.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant Research as xquik-x-research
  participant MCP as xquik MCP
  participant Xquik as Xquik service
  User->>Research: Ask a public X research question
  Research->>MCP: Inspect tools and submit searches
  MCP->>Xquik: Send authenticated MCP requests
  Xquik-->>MCP: Return results and pagination data
  MCP-->>Research: Return evidence and provenance
  Research-->>User: Report findings and coverage
Loading

Possibly related PRs

Suggested reviewers: duyet

Poem

I’m a rabbit with research to do,
Through MCP trails fresh facts pursue.
Safe keys tucked and sources bright,
Read-only hops from day to night.
Xquik joins the plugin crew—
Thump, thump, a catalog update too!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly reflects the main change: adding the Xquik research plugin plus metadata validation guards.
✨ 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.

@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 reviewed your changes and they look great!


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.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request introduces the xquik plugin, which enables research of public X conversations through a remote MCP server. The changes include adding the plugin to various marketplace configuration files, updating the README documentation and plugin badges, and providing the necessary configuration, instructions, and skill definitions under the new xquik/ directory. Feedback on the pull request points out that the totalPlugins metadata field in marketplace.json should be updated to 24 to maintain consistency with the actual count of registered plugins.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread marketplace.json
@kriptoburak kriptoburak changed the title feat(xquik): add research plugin feat(xquik): add research plugin and metadata guards Jul 18, 2026
@coderabbitai
coderabbitai Bot requested a review from duyet July 18, 2026 10:21

@coderabbitai coderabbitai 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@xquik/.codex-plugin/plugin.json`:
- Around line 5-7: Synchronize the plugin metadata manifests: update
xquik/.codex-plugin/plugin.json at lines 5-7 to add author.url, homepage,
repository, and license using the matching values from
xquik/.claude-plugin/plugin.json at lines 5-8 and 9-11; no direct changes are
required in the Claude manifest.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: da36da63-7c23-4667-bb50-7e0de4981da0

📥 Commits

Reviewing files that changed from the base of the PR and between 82de402 and cdff988.

📒 Files selected for processing (12)
  • .agents/plugins/marketplace.json
  • .claude-plugin/marketplace.json
  • README.md
  • marketplace.json
  • scripts/validate-plugins.sh
  • xquik/.claude-plugin/plugin.json
  • xquik/.codex-plugin/plugin.json
  • xquik/.mcp.json
  • xquik/CLAUDE.md
  • xquik/LICENSE
  • xquik/README.md
  • xquik/skills/xquik-x-research/SKILL.md

Comment thread xquik/.codex-plugin/plugin.json
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