CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

x-search

MUST read before searching X/Twitter with the x_search tool. When xAI is connected: date-bound every time-sensitive query (from_date >= yesterday, widen to 7 days), scope trusted accounts with allowed_x_handles, phrase queries as latest/recent with since:/from:/filter: operators, split into 2-3 searches by account and by keyword, and reconcile against web_search. Triggers: X search, Twitter search, tweets, posts on X, what people are saying on X, x_search, social signal.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, tightly written instruction skill: it provides copy-ready query recipes, explicit failure-mode handling and reconciliation checkpoints, and skill-specific knowledge Claude cannot infer. The minor deductions are for the operator cheat sheet restating widely known X search operators and the absence of any reference structure at ~120 lines of body content.

DimensionReasoningScore

Conciseness

The body is efficient and focused on what Claude cannot know (tool_search activation, server-side sub-tool behavior, "$5 per 1,000 calls", the "Queries used:" trailer), but the operator cheat sheet largely restates standard X advanced-search operators (`since:`, `until:`, `from:`, `filter:`, `lang:`) that Claude already knows — only the since:→Latest-mode observation adds new information. This is minor trimmable over-explanation, matching the 4 anchor rather than 5.

4 / 5

Actionability

Fully executable for an instruction-only skill: exact commands (`tool_search "X posts"`), copy-ready query templates with concrete parameter examples (`allowed_x_handles: ["growth_papa", "aleabitoreddit"]`, `from_date: <yesterday>`), and explicit fallback phrasing. The placeholders are justified since the skill mandates computing dates at runtime, and the templates cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The sequence is explicit — availability check, date-bounding, handle/keyword/thread passes, "Stop after three passes", then web_search reconciliation — with feedback loops for each failure mode (thin results → widen once then stop; disagreeing passes → report both; X-only claims → flag unconfirmed; no xAI credential → fall back to web_search). Explicit checkpoints and error-recovery loops match the 5 anchor; this is not a destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers and everything is appropriately inline for a compact single-purpose skill, but no reference files exist and the body is ~120 lines, so the under-50-line simple-skill exception does not strictly apply; the operator cheat sheet and split-search recipe are extraction candidates if the skill grows. Good structure with everything appropriately placed matches the 4 anchor better than 5, which expects well-signaled one-level-deep references.

4 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A high-quality description: it names concrete, parameter-level actions, answers both what and when explicitly, and carries a rich natural-language trigger list including synonyms and colloquial phrasing. The only weakness is the slightly broad "social signal" trigger, which introduces minor overlap risk with non-X social-media skills.

DimensionReasoningScore

Specificity

Lists five concrete actions with parameter-level detail — "date-bound every time-sensitive query (from_date >= yesterday, widen to 7 days)", "scope trusted accounts with allowed_x_handles", "phrase queries as latest/recent with since:/from:/filter: operators", "split into 2-3 searches", "reconcile against web_search" — which matches the comprehensive-coverage anchor. It is not 4 because there are no coverage gaps; parameters, escalation behavior, and cross-checking are all explicitly named.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the set of five operational rules for shaping x_search queries, and the "when" is stated twice — "MUST read before searching X/Twitter with the x_search tool. When xAI is connected" plus a concrete "Triggers:" list. This matches the 5 anchor (clear, explicit what AND when with concrete trigger phrases), not the 4 anchor where the "when" is only loosely specified.

5 / 5

Trigger Term Quality

The explicit trigger list — "X search, Twitter search, tweets, posts on X, what people are saying on X, x_search, social signal" — covers both platform names, tweets/posts synonyms, a natural colloquial phrase users would actually say, and the tool name. Comprehensive synonym coverage matches the 5 anchor rather than the 4 anchor, since no obvious natural term is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — X/Twitter search via xAI's x_search with X-specific triggers — but "social signal" is a broad term that could overlap with general social-media or sentiment-analysis skills, creating minor overlap risk. This fits the 4 anchor (mostly distinct, minor overlap with closely related skills) better than 5, which requires minimal conflict risk across all triggers.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

code-yeongyu/oh-my-openagent

Path

packages/omo-senpi/src/components/x-search/skill/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.