CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

keenable-search

Keyless web search and page fetch via Keenable. Use when user says "keenable search", "web search without an API key", "fetch this page as markdown", or needs broad web results beyond academic databases (arXiv, Semantic Scholar) with no search API key set up.

Quality

82%

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

82%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 well-built operational skill: fully executable commands, a sensible multi-step workflow with explicit failure handling for script resolution, and clean section organization. The main improvements are removing the duplicated 'Key Rules' content, adding output-validation guidance for the search step, and moving the inline resolver boilerplate into a shipped reference file.

Suggestions

Merge the 'Key Rules' bullets into the sections that already cover them (Setup, Step 1, Step 3) to remove repetition and trim tokens.

Add a short validation branch to Step 3/4 for empty results, malformed JSON, or a 429 mid-search (wait-and-retry) so the workflow has a complete feedback loop.

Ship or inline the resolution-chain logic (and the integration-contract policy it cites) so no step depends on a file absent from the skill's own bundle.

DimensionReasoningScore

Conciseness

The body is largely commands, tables, and terse rules with no padding of concepts Claude already knows, matching anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed'). Trim candidates keep it below 5: the 'Key Rules' section repeats guidance already given in Setup/Workflow (key handling, site filter, 429 retry), and 'Search query: $ARGUMENTS' near the top duplicates Step 1.

4 / 5

Actionability

Guidance is fully executable: the Step 2 shell chain is copy-paste ready with its own error messages and remediation hints, Step 3 gives concrete invocations for standard search, filtered search, and URL fetch, and the JSON output schema (title/url/snippet/published_date, content/author, errors) is specified. This matches anchor 5 ('copy-paste ready code or commands; specific examples cover the common cases'); a 4 would require a missing flag or an example that fails to run as written.

5 / 5

Workflow Clarity

A clear five-step sequence (Parse Arguments, Locate Script, Execute Search, Present Results, Offer Follow-up) with a real validation checkpoint: unresolved helper terminates with explicit remediation and exit 1, and fetch failures are surfaced under 'errors' with 429 retry guidance. It falls short of anchor 5 because there is no explicit validation of the search output itself (e.g., what to do when the JSON is empty or malformed), which is the minor validation gap anchor 4 describes. No destructive/batch cap applies.

4 / 5

Progressive Disclosure

Structure is good: clearly headed sections, and external detail is pushed to a clearly signaled one-level-deep reference — '[shared-references/integration-contract.md](../shared-references/integration-contract.md) §2' — rather than inlined. This matches anchor 4 ('Good structure; most content appropriately placed; references mostly clear; minor organization gaps'). It is not 5 because the ~16-line script-resolution boilerplate in Step 2 is the kind of environment plumbing that belongs in a reference file, and the referenced integration-contract.md does not exist in this skill's bundle layout (the link is dangling when the skill is reviewed standalone), leaving a navigation gap.

4 / 5

Total

17

/

20

Passed

Description

78%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, third-person description with an explicit 'Use when' clause and genuinely natural trigger phrases. Its main weakness is that the 'what' half only surfaces two actions, underselling the skill's concrete capabilities (filters, per-result snippets, markdown fetch).

Suggestions

Expand the 'what' clause with two or three more concrete capabilities, e.g., 'Returns a page-text snippet per result, supports site and date filters, and fetches known URLs as clean markdown' to lift specificity.

Add one or two everyday synonyms to the trigger list, such as 'search the web' or 'look this up online', to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "Keyless web search and page fetch via Keenable" — but stops there; capabilities like site/date filtering or snippet-per-result are not mentioned, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not list several specific actions (only two verbs: search, fetch), and not a 2 because the actions given are concrete, not generic.

3 / 5

Completeness

Both questions are explicitly answered: what — "Keyless web search and page fetch via Keenable"; when — "Use when user says 'keenable search', 'web search without an API key', 'fetch this page as markdown', or needs broad web results beyond academic databases (arXiv, Semantic Scholar) with no search API key set up". This matches anchor 5 (clear what AND when with concrete trigger phrases); a 4 would require the 'when' clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are quoted directly: "keenable search", "web search without an API key", "fetch this page as markdown", plus the scenario of needing results beyond arXiv/Semantic Scholar with no key set up. It falls short of anchor 5 because common synonyms like "search the web", "look this up online", or "fetch this URL" are missing; it is clearly above anchor 3 since multiple natural trigger phrases are covered.

4 / 5

Distinctiveness Conflict Risk

The skill has a clear niche (keyless web search, explicitly contrasted with arXiv/Semantic Scholar and no-API-key setup), and the distinctive trigger "keenable search" minimizes confusion. It is not a 5 because "fetch this page as markdown" and generic web search overlap with other web-search/fetch skills (e.g., /exa-search), leaving minor overlap risk with closely related skills — anchor 4.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/keenable-search/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.