CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

beamer

Beamer integration. Manage Organizations, Users, Filters. Use when the user wants to interact with Beamer data.

Quality

68%

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/beamer/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 content is a solid, command-driven integration guide with genuinely actionable CLI examples and good state-handling guidance for connections. The main deductions are mild marketing/aside padding, a broken step-reference scheme ("Step 2" and "1b" without matching labels), and — most significantly — destructive actions (deletes) offered with no validation or confirmation workflow, which caps workflow clarity.

Suggestions

Add validation guidance around destructive operations: confirm the target ID with the user before delete-post/delete-user/delete-comment, and verify with a get/list call afterward (this lifts the workflow_clarity cap).

Fix the incoherent step labels — "skip to Step 2" points to a step that doesn't exist, and "#### 1b" has no matching "1a"; either number the steps consistently or drop the labels.

Trim padding: cut the product-marketing intro sentence and the "Agent Types" aside (or compress it to a parenthetical on the login command), and clarify the "--tenant" flag's value.

DimensionReasoningScore

Conciseness

The body is mostly command-first and efficient, but contains unnecessary padding: the intro paragraph ("helps product teams keep users informed and engaged") is product-marketing context Claude doesn't need, and the "Agent Types : claude, openclaw, codex, warp, windsurf, etc." aside with its ungrammatical trailing sentence adds little. Fits anchor 3 (mostly efficient, some unnecessary explanation) rather than anchor 4, since there are several such spots, not just minor instances.

3 / 5

Actionability

Commands are concrete and executable throughout — "npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://www.getbeamer.com/\" --json", the action run/proxy flag tables, and an 18-row action catalog. Falls short of anchor 5 only on minor gaps: no filled-in example of running a specific action with a real --input payload, and "membrane login --tenant --clientName=<agentType>" is ambiguous (--tenant takes no shown value).

4 / 5

Workflow Clarity

The install → login → connect → wait → search → run sequence is present with a state-based feedback loop (CLIENT_ACTION_REQUIRED → poll again until READY). However, the flow references "skip to **Step 2**" when no numbered steps or Step 2 exist (and "1b" appears with no "1a"), and the skill exposes destructive operations (Delete Post, Delete User, Delete Comment) with no validation/confirmation guidance — per the rubric cap, destructive operations without validation steps cap workflow clarity at 3.

3 / 5

Progressive Disclosure

The single file is well-organized with clear section headers (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) and no nested references. It falls short of anchor 5 because the 18-row action catalog and proxy options table are bulk reference material that could live in a separate file, keeping the SKILL.md body leaner. Not anchor 3, since nothing is buried and structure is consistent.

4 / 5

Total

14

/

20

Passed

Description

62%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 (domain, entities, explicit 'Use when' clause) and scores in the solid middle range. Its weaknesses are generic action verbs, a trigger list that misses the natural Beamer vocabulary (changelog, posts, comments, feature requests, NPS), and a naming collision with LaTeX Beamer. The listed entities (Organizations, Filters) also misalign with the action catalog the body actually showcases.

Suggestions

Replace the generic "Manage Organizations, Users, Filters" with concrete actions that mirror the skill's catalog, e.g. "Create and announce posts, manage comments, collect and count feature requests, check NPS prompts, manage users."

Add natural trigger vocabulary to the 'Use when' clause: changelog, product announcements/updates, user feedback, NPS surveys — terms a user would actually say.

Disambiguate from LaTeX Beamer by signaling the SaaS product context, e.g. "Beamer (the SaaS changelog/announcements product), not the LaTeX beamer class."

DimensionReasoningScore

Specificity

"Manage Organizations, Users, Filters" names the domain and several entities, but "Manage" is a single generic verb with no concrete actions (e.g., create posts, list comments, check NPS) — above anchor 2's minimal/generic actions yet short of anchor 4's several specific actions. Notably, the entities listed don't match the actions the skill body actually emphasizes (posts, comments, feature requests).

3 / 5

Completeness

Both parts are present: what = "Beamer integration. Manage Organizations, Users, Filters", when = "Use when the user wants to interact with Beamer data". The 'when' clause is explicit but generic ("Beamer data"), so it fits anchor 4 ('when' could be more explicit or specific) rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

"Beamer", "Users", and "Beamer data" are relevant keywords, but the common natural terms users would say for this product — changelog, announcements/posts, comments, feature requests, NPS — are absent. Matches anchor 3 (some relevant keywords, missing common variations and synonyms) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Beamer" carves a clear product niche, but it collides with the widely-used LaTeX Beamer presentation class, so a user mentioning "beamer" in a LaTeX/presentation context could trigger this skill wrongly. This is exactly anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than anchor 5's minimal conflict risk.

4 / 5

Total

14

/

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