CtrlK
BlogDocsLog inGet started
Tessl Logo

alegra

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

55

Quality

62%

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/alegra/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 is action-oriented and well-structured with executable membrane commands and a robust, validated connection workflow. It loses points on conciseness due to a redundant intro paragraph and a largely uninformative popular-actions table, and the search-to-run steps could be woven into one explicit end-to-end sequence.

Suggestions

Trim or remove the opening paragraph explaining what Alegra is and who uses it; Claude can infer this and it competes with context budget.

Drop or enrich the popular-actions table rows that say 'No description' so the table carries actionable information rather than empty cells.

Add a short numbered end-to-end workflow (connect -> search actions -> run action / proxy) so the full path is explicit rather than implied across sections.

DimensionReasoningScore

Conciseness

Mostly efficient with executable commands, but the opening paragraph explains what Alegra is (a concept Claude can infer) and the ~20 'No description' rows in the popular-actions table are padding that adds tokens without value.

3 / 5

Actionability

Provides concrete, copy-paste-ready membrane commands with flags and JSON examples for connecting, searching, running actions, and proxying, with only minor gaps (the action table rows lack descriptions).

4 / 5

Workflow Clarity

The connection flow is clearly sequenced with explicit state-based validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and feedback loops for re-polling and error recovery, though the search-to-run path is not tied into a single end-to-end ordered workflow.

4 / 5

Progressive Disclosure

A single self-contained SKILL.md is well-organized with clear section headers and easy navigation, appropriate given no external references; the only gap is inline reference-like content (the popular-actions table) that could be tightened.

4 / 5

Total

15

/

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 identifies the Alegra niche and includes an explicit 'Use when' trigger, but its capability list is generic ('manage data, records, automate workflows') rather than naming Alegra's concrete functions. Tightening it to mention invoices, contacts, billing, and accounting would raise specificity and trigger quality.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Alegra capabilities, e.g. 'Create and manage invoices, contacts, items, and payments, and automate accounting workflows.'

Expand the trigger clause to include natural user phrases: 'Use when the user wants to manage Alegra invoices, contacts, billing, or accounting data.'

Add the file/domain hints users actually cite (e.g. alegra.com, invoicing) to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

Names the Alegra domain but the actions ('Manage data, records, and automate workflows') are minimal and generic rather than concrete capabilities like invoicing, contacts, or billing.

2 / 5

Completeness

Provides both a 'what' (Alegra integration, manage data/records, automate workflows) and an explicit 'when' ('Use when the user wants to interact with Alegra data'), though the when could name concrete triggers more specifically.

4 / 5

Trigger Term Quality

Includes the natural trigger term 'Alegra' and an explicit 'Use when' clause, but misses common synonyms users would say (invoices, contacts, accounting, billing).

3 / 5

Distinctiveness Conflict Risk

The named app 'Alegra' anchors the skill to a clear niche with minimal conflict risk, though the generic 'manage data, records' phrasing leaves minor overlap 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.

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