CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

x-integration

X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".

Quality

88%

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

77%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.

Highly actionable and well-sequenced content with per-step verification and strong troubleshooting coverage, held back by redundancy and monolithic structure. Merging the duplicated setup sections and splitting integration details and selectors into reference files would improve both weak dimensions.

Suggestions

Merge the Quick Start and Setup sections — the authenticate/rebuild/restart workflow appears in both, and the setup command appears a third time under Troubleshooting 'Authentication Expired'; keep one canonical sequenced walkthrough and link the rest.

Move the Integration Points source-diff instructions and the X UI selector table into separate reference files (e.g., references/integration.md, references/selectors.md) so SKILL.md stays a lean overview with one-level-deep references.

Ship the referenced files in the bundle or remove the instructions that depend on them — scripts import from '../lib/browser.js' and the body says to edit 'lib/config.ts', 'host.ts', and 'agent.ts', but none of these are present alongside scripts/.

DimensionReasoningScore

Conciseness

The body is dense (tables, commands, code diffs) with no concept over-explanation, but the same setup workflow (authenticate, rebuild, restart) is repeated three times — in Quick Start, in the '## Setup' section, and again under Troubleshooting 'Authentication Expired'. The duplication is more than minor trimming, sitting between the 'could be tightened' (3) and 'efficient' (4) anchors, and closer to 3 given an entire redundant section.

3 / 5

Actionability

Fully executable throughout: copy-paste bash commands with inline verification steps, concrete find/replace source diffs for all four integration points, a selector table for UI breakage, and stdin-pipe test invocations that match the actual bundled scripts. This is the 'copy-paste ready, covers common cases' level-5 anchor.

5 / 5

Workflow Clarity

Setup is a clearly numbered sequence with an explicit 'Verify success:' checkpoint after every step (auth file check, build output grep, service status), and troubleshooting provides feedback loops (re-authenticate when expired, remove Singleton lock files when Chrome fails to launch, timeout adjustment, selector-refresh guidance). Matches the level-5 anchor with validation and error-recovery loops.

5 / 5

Progressive Disclosure

Well-sectioned single document, but everything is inlined in one ~420-line file: the Integration Points source-diff instructions and the selector table clearly belong in separate reference files, and the body instructs editing 'lib/config.ts' while bundled scripts import '../lib/browser.js' — neither file is present in the bundle (only scripts/ exists). Better organized than 'minimal structure' (2) but content that should be separate is inline (3), short of 'appropriately placed' (4).

3 / 5

Total

16

/

20

Passed

Description

92%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 strong description: concrete action list, explicit use-when guidance with trigger phrases, and a distinct niche. The only weakness is trigger coverage missing a few natural variations users might say.

DimensionReasoningScore

Specificity

Lists five concrete actions ("Post tweets, like, reply, retweet, and quote") that exactly match the skill's feature set, plus setup/testing/troubleshooting purposes. Coverage is comprehensive with no gaps, matching the level-5 anchor rather than the 'minor gaps' of level 4.

5 / 5

Completeness

Explicitly answers both: what ("Post tweets, like, reply, retweet, and quote") and when ("Use for setup, testing, or troubleshooting X functionality. Triggers on 'setup x', 'x integration', 'twitter', 'post tweet', 'tweet'"). Concrete trigger phrases place it squarely at the level-5 anchor.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ("twitter", "post tweet", "tweet", "setup x") but misses common variations like "retweet", "like", "quote tweet", or "x.com". Good coverage above the 'some relevant keywords' anchor but short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (X/Twitter integration for NanoClaw) with distinct triggers ('twitter', 'post tweet', 'tweet') that are unlikely to fire for unrelated skills. Minimal conflict risk matches the level-5 anchor.

5 / 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

jbaruch/nanoclaw-telegram

Path

.claude/skills/x-integration/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.