Add X MCP guide skill to X plugin - #228
Merged
maloneya merged 2 commits intoAug 19, 2026
Merged
Conversation
Maps X API error responses (401/402/403/429/409) to the developer-account state that caused them, with auth-mode guidance and cost-aware retry rules so agents don't burn prepaid credits on blind retries. Co-authored-by: Cursor <cursoragent@cursor.com>
Reframes the skill around the X MCP Connect flow: three core errors (sign-in, not onboarded, out of credits) with exact lines to say to the user, plus session-start probing, search operators, and cost-aware workflow rules. Drops the developer-account error decode table. Co-authored-by: Cursor <cursoragent@cursor.com>
maloneya
changed the title
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.
Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.
Reviewed by Cursor Bugbot for commit a367027. Configure here.
|
|
||
| > This X account isn't set up yet. Go to https://console.x.com, register and onboard with this same X account, then come back and I'll retry. | ||
|
|
||
| Do not retry. Do not search. Do not mention apps, projects, or pay-per-use. If they already did that, ask them to reconnect, probe once, and if it still 403s say the same line again. |
There was a problem hiding this comment.
403s misrouted as not onboarded
Medium Severity · Logic Bug
The not-onboarded matcher treats any 403 on timeline, mentions, search, or bookmarks after Connect as enrollment failure, and that branch wins before not-authorized-for-resource. Agents then give the console onboarding line, refuse to retry, and skip the private-resource path for protected accounts or missing access.
Additional Locations (1)
Reviewed by Cursor Bugbot for commit a367027. Configure here.
github-actions Bot
added a commit
to SmailG/claude-cursor-plugins
that referenced
this pull request
Aug 20, 2026
…maloneya/amaloney/x-plugin-api-guide-skill chore: sync with cursor/plugins — Merge pull request cursor#228 from maloneya/amaloney/x-plugin-api-guide-skill
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
client-not-enrolled/user-not-enrolled), and out of credits — each with an exact, simple line to say to the user, and rules to never retry them unchanged or explain billing/enrollment internals."skills": "./skills/"in the plugin manifest (the plugin had no skills before), bumps the version to 2.1.0, and adds a changelog entry.Test plan
schemas/plugin.schema.json(skillsis a supported field; JSON parses cleanly)