CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

biztera

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

Quality

64%

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/biztera/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 CLI guidance with a well-sequenced connection and action workflow, but nearly half of it is a padded, duplicate-ridden entity list that wastes context and belongs in a separate reference file. Trimming the intro and moving the entity catalog out would make this a genuinely efficient skill document.

Suggestions

Move the ~170-line entity list into a separate references/ file (e.g., references/entities.md) and replace it in the body with a one-line pointer, removing the duplicate entries (Alert, Comment, Event, File, Folder, Link, Message, Review, Task, etc. appear twice).

Delete the marketing-style intro paragraph about what Biztera is and the vacuous line 'Use action names and parameters as needed.' — they add tokens without actionable guidance.

Fix the internal step references ('skip to Step 2' with no labeled Step 2; a '#### 1b.' heading with no '1a') by numbering the connection workflow consistently.

DimensionReasoningScore

Conciseness

The ~170-line flat entity list (with many duplicate entries: Alert, Comment, Event, File, Folder, Link, Message, Notification, Review, Task each appear twice) and the marketing-style intro paragraph ('Biztera is a business management platform designed to help small to medium-sized businesses streamline their operations...') plus the vacuous line 'Use action names and parameters as needed.' add substantial padding. This matches anchor 2 ('Noticeably verbose; several unnecessary explanations or padded sections'); it is not 1 because the CLI workflow sections themselves are lean and command-focused.

2 / 5

Actionability

Concrete, executable commands appear throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://biztera.com/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input \'{"key": "value"}\' --json', plus a proxy options table. This matches anchor 4 ('Mostly executable guidance; concrete code or commands with minor gaps'); it is not 5 because 'Use action names and parameters as needed' is vague and there is no worked end-to-end example with real values.

4 / 5

Workflow Clarity

A clear sequence is present (install → login → connection ensure → poll until READY → handle CLIENT_ACTION_REQUIRED → search actions → run), with state-based branching, a re-poll feedback loop after user actions, and error handling ('CONFIGURATION_ERROR or SETUP_FAILED — check the error field'). This matches anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps'); it is not 5 because 'skip to Step 2' references a step that is never labeled, and action-run outputs are not validated.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers and no nested references, but the ~170-line entity list is inline content that clearly belongs in a separate reference file, matching anchor 3 ('Some structure but could be better organized... content that should be separate is inline'). It is not 2 because the rest of the body is appropriately sectioned and navigable; not 4 because the entity list is exactly the kind of bulk content that should be split out.

3 / 5

Total

13

/

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 correctly includes an explicit 'Use when...' trigger clause and names a distinct target app, but the capability statement is generic. Replacing 'Manage data, records, and automate workflows' with 2-3 concrete Biztera operations would lift specificity and trigger quality substantially.

Suggestions

Name concrete actions instead of 'Manage data, records, and automate workflows' — e.g., 'Create and update projects, manage invoices and approval requests, list notifications and messages'.

Add natural trigger synonyms users would say, such as 'Biztera, Biztera projects, Biztera invoices, business records', to improve trigger term coverage.

Optionally mention the official docs domain (developers.biztera.com) only if it aids discoverability; keep the description focused on capabilities and triggers.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Biztera domain but the actions are generic — no concrete operations (e.g., create projects, list invoices, manage approval requests) that the skill body shows are available. It matches the anchor 'Names the domain but actions are minimal or generic' and falls short of 3 because not even 1-2 truly concrete actions are stated.

2 / 5

Completeness

Both a 'what' ("Manage data, records, and automate workflows") and an explicit 'when' ("Use when the user wants to interact with Biztera data") are present, matching anchor 4. It is not 5 because the 'what' is vague and the trigger phrase is generic; not 3 because the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ("Biztera", "data", "records", "workflows") and a user mentioning Biztera would naturally trigger it, but common variations and task-level terms (projects, invoices, CRM, approval requests) are missing. It fits anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than 4 because coverage beyond the app name is thin.

3 / 5

Distinctiveness Conflict Risk

Naming the specific app "Biztera" creates a clear niche with minimal conflict risk against other skills, matching anchor 4 ('Mostly distinct; minor overlap risk'). It is not 5 because the generic 'manage data' phrasing could overlap with other data-management 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/biztera/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.