feat: add x-search skill for X/Twitter research#28
Merged
Conversation
Research and PRD for integrating rohunvora/x-research-skill as an x-search skill in the sdlc-plugin. Includes multi-LLM blindspot review (Codex + Gemini) with consolidated findings.
Port and adapt rohunvora/x-research-skill CLI for sdlc-plugin conventions: - SKILL.md with frontmatter, research loop, and CLI reference - TypeScript CLI under utils/x-search/ with 6 commands (search, thread, profile, tweet, watchlist, cache) - Env-var-only auth (X_BEARER_TOKEN), no file fallback - Default markdown output instead of Telegram format - --save writes to CWD, not hardcoded ~/clawd/drafts/ - 401/403/429 error handling with actionable messages - Thread root tweet bug fix (single tweet response parsing) - Fixture-based unit tests for parseTweets and deduplication - --include-retweets flag (retweets excluded by default) - --limit respected across all output formats
Transforms the x-search skill from rule-based (4.6/10) to reasoning-based (~7.5/10) per Anthropic Constitution principles. Replaces exhaustive CLI flag enumeration with concise reference that trusts --help, converts 6-step procedural research loop into principles-based approach, and adds reasoning to all constraints explaining why they matter for decisions.
iamladi
added a commit
that referenced
this pull request
Apr 20, 2026
…tes" catchall headers per iter-12 guidance, absorbing duplicated blast-radius content into Invocation shape and promoting user-handoff discoverability hooks to a semantic "After the run" section.
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
/x-searchskill for X/Twitter research from Claude Codeutils/x-search/with 6 commands: search, thread, profile, tweet, watchlist, cacheChanges
X_BEARER_TOKEN), markdown default output,--savewrites to CWD--no-retweetsto--include-retweets(P1 logic fix),--limitrespected across all output formats, NaN guards on numeric flags, stderr logging for thread catchparseTweets, deduplication, sorting, filtering.gitignoreentriesPlan
plans/x-search-skill-integration.mdReview
Code reviewed by GPT-5.2-Codex (xhigh) and Gemini 3 Pro. All P1 and P2 findings addressed.
Validation
bun run validatepassesbun test utils/x-search/tests/— 12/12 pass~/clawd/or~/.config/env/pathsTest plan
bun run utils/x-search/x-search.tsshows usage helpbun test utils/x-search/tests/— 12 tests passbun run validatepassesgrep -r "clawd\|global\.env" utils/x-search/ skills/x-search/returns no matchesX_BEARER_TOKEN:bun run utils/x-search/x-search.ts search "test"returns markdown results