CtrlK
BlogDocsLog inGet started
Tessl Logo

node-connect

Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps. Use when QR/setup code/manual connect fails, local Wi-Fi works but VPS/tailnet does not, or errors mention pairing required, unauthorized, bootstrap token invalid or expired, gateway.bind, gateway.remote.url, Tailscale, or plugins.entries.device-pair.config.publicUrl.

78

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is concise, highly actionable, and sequences the diagnostic workflow with explicit checkpoints and feedback loops. Structure is clean and self-contained, though it makes no use of split-out reference files.

Suggestions

If the root-cause map or canonical-command reference grows, split it into a references/ file and link from SKILL.md to push progressive_disclosure to 5.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: it never explains what OpenClaw or Tailscale is, and every line (topology cases, canonical commands, root-cause map) earns its place.

5 / 5

Actionability

It provides copy-paste-ready, executable commands (openclaw qr --json, openclaw config get ..., openclaw devices approve --latest, tailscale status --json) and documents the concrete result fields (gatewayUrl, urlSource) needed to act.

5 / 5

Workflow Clarity

A clear sequence (topology decision -> ask if ambiguous -> canonical checks -> read results -> root-cause map -> one route) with explicit checkpoints ("Read the result, not guesses", approve before changing config) and error-recovery feedback (fix route, regenerate setup code, rescan).

5 / 5

Progressive Disclosure

Well-organized with clear section headers and no nested references or monolithic wall, but it is a single self-contained doc with no file-level navigation, so it sits just below the top anchor which centers on one-level-deep references.

4 / 5

Total

19

/

20

Passed

Description

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

The description is specific, complete, and rich with natural trigger terms, clearly answering both what the skill does and when to invoke it. It is highly distinct with minimal conflict risk.

DimensionReasoningScore

Specificity

"Diagnose OpenClaw node connection and pairing failures" names the domain, and the description enumerates many concrete failure modes and config keys (QR/setup code/manual connect fails, local Wi-Fi works but VPS/tailnet does not, gateway.bind, gateway.remote.url), giving comprehensive coverage.

5 / 5

Completeness

It explicitly states both what the skill does ("Diagnose OpenClaw node connection and pairing failures") and when to use it via an explicit "Use when" clause listing concrete conditions and error strings.

5 / 5

Trigger Term Quality

It packs in natural user phrases ("can't connect", "pairing required", "unauthorized", "QR/setup code", "Wi-Fi", "VPS", "Tailscale") plus synonyms (QR/setup code/manual) and technical trigger terms, giving comprehensive keyword coverage.

5 / 5

Distinctiveness Conflict Risk

The OpenClaw node-pairing niche with named config keys (plugins.entries.device-pair.config.publicUrl) and platform-specific companion apps is a clear, distinct trigger set with minimal overlap risk.

5 / 5

Total

20

/

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
qsimeon/openclaw-engaging
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.