CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

addsearch

AddSearch integration. Manage data, records, and automate workflows. Use when the user wants to interact with AddSearch data.

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/addsearch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 delivers strong, copy-paste-ready Membrane CLI guidance with real feedback loops around connection states — its biggest strengths are actionability and structure. Its weaknesses are broken sequencing references (a never-defined 'Step 2' and an orphaned '1b' heading), padding (marketing opener, empty Overview list, duplicated discovery command), and a 'Popular actions' section that names no actions.

Suggestions

Fix the broken step references: either label the sections as Step 1 / Step 2 or rewrite 'skip to Step 2' as 'skip to Searching for actions', and renumber the orphaned '1b' heading to match a coherent scheme.

Cut the marketing opener and the content-free 'AddSearch Overview' bullet list, and deduplicate the action-discovery command (pick one invocation style — `membrane` vs `npx @membranehq/cli@latest`).

Make 'Popular actions' earn its title by listing 3-5 actual AddSearch action examples (e.g. search, index status, crawler setup) with sample `membrane action run` invocations, or fold the discovery instructions into the 'Searching for actions' section.

DimensionReasoningScore

Conciseness

The body is mostly efficient commands, but contains trimmable padding: the marketing opener "AddSearch is a hosted search solution for websites. It allows website owners to provide a better search experience", the content-free "AddSearch Overview" bullet list (Search/Result/Index/Configuration/Account), and a redundant repeat of the action-discovery command (once as `membrane action list`, once as `npx @membranehq/cli@latest action list`). Fits anchor 3 (mostly efficient but some unnecessary explanation); not 4 because there are several such sections, not just minor instances.

3 / 5

Actionability

Concrete, executable commands throughout — install, login (including headless completion), connection ensure, polling with --wait, action run with --input JSON, and a proxy flags table. Fits anchor 4 (mostly executable, minor gaps) rather than 5 because the "Popular actions" section lists no actual AddSearch actions (only discovery instructions), and CLI invocation is inconsistent between `membrane` and `npx @membranehq/cli`.

4 / 5

Workflow Clarity

A rough sequence exists (install → login → connect → poll → act) with genuinely good state-based feedback loops (poll until not BUILDING, re-poll after user completes auth, check the error field on CONFIGURATION_ERROR/SETUP_FAILED). However, "If the returned connection has state: READY, skip to Step 2" references a Step 2 that is never labeled anywhere, and the "1b" heading has no corresponding numbered step scheme — the sequence is present but its checkpoints and flow references are broken. Fits anchor 3; not 4 because dangling step references make the intended order impossible to follow as written.

3 / 5

Progressive Disclosure

Single-file skill with no bundle files and no references to nonexistent files; sections are clearly headed (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) and content is appropriately placed for a ~140-line skill. Fits anchor 4 (good structure, minor organization gaps) — the useless Overview bullet list and the reference-grade proxy flags table are the minor gaps; not 3 since nothing is buried or clearly misplaced for this skill size.

4 / 5

Total

14

/

20

Passed

Description

57%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 has the right structure — a named domain, a what-statement, and an explicit 'Use when' clause — but the capability statement is generic integration boilerplate rather than concrete AddSearch operations. Brand-specificity keeps conflict risk low, yet almost no AddSearch-specific vocabulary (index, crawl, search results) is present to help trigger it naturally.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete AddSearch operations, e.g. 'Index website content, run and configure site search, manage search results and records'.

Expand the 'Use when' clause with natural trigger phrases users would actually say: 'Use when the user mentions AddSearch, site search, search index setup, or crawling/indexing a website'.

Mention AddSearch-specific vocabulary (index, crawler, search results, dashboard configuration) so the skill triggers on domain terms rather than only the brand name.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the AddSearch domain but the actions are generic boilerplate — no concrete operations like indexing pages, searching records, or configuring crawlers. It matches anchor 2 (domain named, actions minimal/generic), not 3, because no concrete action is actually listed.

2 / 5

Completeness

Explicitly answers both: what ("AddSearch integration. Manage data, records, and automate workflows") and when ("Use when the user wants to interact with AddSearch data"). Fits anchor 4 (both present, 'when' could be more specific) — not 5 because the 'what' is vague and the 'when' is near-circular, not 3 because the when-clause is explicitly stated.

4 / 5

Trigger Term Quality

"AddSearch" is a strong, specific brand trigger, but beyond it only "data" and "records" appear — natural variations users would say (site search, search index, crawler, search results) are missing. Fits anchor 3 (some relevant keywords, missing common variations); not 4 because coverage beyond the brand name is thin.

3 / 5

Distinctiveness Conflict Risk

The AddSearch brand anchors a clear niche with minimal conflict risk for search-related work, but "manage data, records, and automate workflows" is generic phrasing shared by many app-integration skills. Fits anchor 4 (mostly distinct, minor overlap risk); not 5 because the generic tail could collide with other integration skills.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/addsearch/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.