CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

archbee

Archbee integration. Manage data, records, and automate workflows. Use when the user wants to interact with Archbee 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/archbee/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 genuinely actionable, executable CLI guidance with strong error-state handling for the connection lifecycle, which is its main strength. Its weaknesses are structural noise: a dangling 'Step 2' reference with an orphaned '1b' subsection, a 'Popular actions' section that contains no actions, a bare entity list that conveys nothing, and inconsistent command invocation styles.

Suggestions

Fix the broken navigation: either define an explicit numbered Step 1/Step 2 sequence or remove the 'skip to Step 2' references and the '1b' heading in favor of a single linear connection setup section.

Either populate 'Popular actions' with the actual most-used Archbee actions or delete the section — as written it only restates the action-list command from the previous section.

Remove the unexplained 'Archbee Overview' entity bullet list and the audience filler sentence, and settle on one consistent command style ('membrane' vs 'npx @membranehq/cli@latest') throughout.

DimensionReasoningScore

Conciseness

The body is mostly efficient — commands are presented tersely — but includes unnecessary padding: the bare 'Archbee Overview' entity list (Document/Block/Space/Collection/... with no explanations, no value), 'It's used by developers, product managers, and technical writers' filler, and a 'Popular actions' section that merely repeats the action-list command from the previous section. Fits anchor 3 ('mostly efficient but includes some unnecessary explanation'); not 2 because there is no extensive explanation of concepts Claude already knows, and not 4 because the redundant sections are clearly trimmable.

3 / 5

Actionability

Concrete, runnable CLI commands cover install, login (including headless completion), connection ensure/poll, action search, action run with JSON input, and proxy requests with a complete flag table — the clientAction state breakdown even gives field-level guidance. Minor gaps keep it at 4: the 'Popular actions' section lists no actual actions, command styles are inconsistent (bare 'membrane' vs 'npx @membranehq/cli'), and the 'Step 2' referenced in the connection flow is never defined.

4 / 5

Workflow Clarity

The sequence (install → authenticate → connection ensure → poll state → act → proxy fallback) is clear and includes real checkpoints: explicit state transitions (READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) with recovery actions for each, and a polling loop with --wait. Not 5 because the flow references 'Step 2' and a '1b' subsection with no Step 1/Step 2 structure actually defined in the document, and there is no guidance for validating action output; not 3 because error-recovery checkpoints are explicitly present rather than implicit.

4 / 5

Progressive Disclosure

The skill is self-contained (no references/, scripts/, or assets/ bundles exist, and the body makes no reference-file claims), organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) that keep the overview-to-detail flow navigable. Minor organization gaps — the dangling 'Step 2' reference, the orphaned '1b' heading, and the empty 'Popular actions' section — hold it at 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Description

50%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 correctly names the Archbee domain and includes an explicit 'Use when' clause, but its capability statement is generic ('manage data, records, and automate workflows') and it misses every natural trigger term for a documentation platform. It reads like a template filled in with a product name rather than a description of what the integration actually does.

Suggestions

Replace the generic capability list with concrete Archbee operations, e.g. 'Create, organize, and share product and API documentation in Archbee; manage spaces, collections, and blocks.'

Add natural trigger terms users would actually say: documentation, docs, API docs, knowledge base, Archbee pages/spaces.

Sharpen the 'Use when' clause with concrete triggers, e.g. 'Use when the user mentions Archbee or wants to create, edit, or publish documentation or API docs.'

DimensionReasoningScore

Specificity

The description names the domain ("Archbee integration") but the stated actions — "Manage data, records, and automate workflows" — are generic and interchangeable with any data tool; no concrete Archbee operations (e.g., create/organize documentation) are listed. This matches the anchor 'Names the domain but actions are minimal or generic'; not 3 because there is no concrete action named, and not 1 because the domain is explicitly identified.

2 / 5

Completeness

Both parts are present: what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Archbee data"). It fits anchor 4 (both present, when could be more specific) but not 5 — the 'what' is generic and the 'when' lacks concrete trigger phrases — and not 3, since the 'when' clause is explicit rather than merely implied.

4 / 5

Trigger Term Quality

The only keyword is "Archbee" (repeated); natural phrases a user would say for this domain — documentation, docs, API docs, knowledge base — are entirely absent. Fits anchor 2 ('One or two generic keywords; missing the natural phrases users say'); not 3 because there isn't even partial coverage of domain-relevant synonyms beyond the product name.

2 / 5

Distinctiveness Conflict Risk

"Use when the user wants to interact with Archbee data" gates triggering on a specific product, giving a clear niche; minor overlap risk remains from the generic "manage data, records, and automate workflows" phrasing that could match broader data-management skills. Mostly distinct (anchor 4) rather than fully minimal-conflict (anchor 5).

4 / 5

Total

12

/

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/archbee/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.