CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

opencli-adapter-author

Build or improve an OpenCLI JS adapter using observed site behavior, existing adapters and browser API evidence. For ad-hoc browser interaction, see opencli-browser.

Quality

81%

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

90%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 an exemplary lean overview: concrete commands, an executable adapter example, real validation steps for a write-capable workflow, and clearly signaled selective references. The only gaps are a not-quite-explicit error-recovery loop and incomplete discoverability of the reference bundle from the main file.

DimensionReasoningScore

Conciseness

The body is lean and every line carries tool-specific facts Claude cannot know (opencli command shapes, the cli({...}) contract, adapter file locations, fixture flags). There is no generic explanation of concepts Claude already knows and no padding, matching the level-5 anchor.

5 / 5

Actionability

Guidance is fully executable: copy-paste shell commands for listing, browser evidence, init, check and test, plus a complete runnable adapter example. The JSON return, typed-error, access and columns contracts are concretely specified, matching the level-5 anchor for executable, common-case-covering examples.

5 / 5

Workflow Clarity

The sections give a clear sequence — reuse existing adapters, gather evidence, author via `adapter init`, then `check`/`test` — with validation checkpoints (`check` validates without executing, fixtures compare results, `--trace retain-on-bailure` diagnoses failures) and explicit write-safety rules (test account, dry-run, 'Do not automatically replay a write with an unknown outcome'). It falls short of level 5 only because there is no explicit fix-and-retest feedback loop spelled out for check/test failures.

4 / 5

Progressive Disclosure

The 'Optional references' section clearly signals five real, one-level-deep files with 'Read only what is useful for the current task', and all five named files exist in references/. It is not level 5 because the bundle contains seven additional reference files (coverage-matrix, field-conventions, jsdom-fixture-pattern, site-recon, strategy-selection, success-rate-pitfalls, typed-errors) not reachable from SKILL.md except by a vague 'Site notes and fixtures are optional knowledge aids' aside, leaving a minor navigation gap.

4 / 5

Total

18

/

20

Passed

Description

65%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 concise, third-person, and precisely scoped to the OpenCLI adapter niche with an explicit boundary against opencli-browser. Its main weaknesses are the absence of a 'Use when...' trigger clause and only two concrete capability verbs, which cap completeness and specificity.

Suggestions

Add an explicit trigger clause, e.g. 'Use when adding or fixing a site command/adapter for OpenCLI, or when the user asks to integrate a site into OpenCLI.'

List a couple more concrete capabilities in the description (e.g., discovering a site's API from network captures, checking and testing adapters with fixtures) to lift specificity from naming just 'build or improve'.

Include natural synonyms users would say (e.g., 'site command', 'site integration', 'scraping a site into a CLI') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Build or improve an OpenCLI JS adapter" names the domain and two concrete actions, while the rest ("observed site behavior, existing adapters and browser API evidence") describes method rather than additional capabilities. It lists 1-2 concrete actions, matching the level-3 anchor, and does not reach level 4's 'several specific actions'.

3 / 5

Completeness

The 'what' is clear (build/improve an OpenCLI JS adapter using evidence), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the closing sentence "For ad-hoc browser interaction, see opencli-browser" is a disambiguation pointer, not a usage trigger. Per the judging guidelines, a missing explicit trigger caps completeness at 3.

3 / 5

Trigger Term Quality

Terms like "OpenCLI JS adapter", "site behavior", "browser API" and "ad-hoc browser interaction" are natural phrases for users in this niche, giving good keyword coverage. A few natural terms users might say (e.g., adding a site 'command', 'integration', or scraping-related wording) are missing, so it falls just short of the level-5 comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

"OpenCLI JS adapter" is a clear niche, and the explicit boundary "For ad-hoc browser interaction, see opencli-browser" defuses the main overlap risk with the sibling browser skill. It matches the level-5 anchor (clear niche with distinct triggers, minimal conflict risk) and is more distinct than the level-4 'minor overlap with closely related skills' example.

5 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

jackwener/OpenCLI

Path

skills/opencli-adapter-author/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.