CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

athenahealth

Athenahealth integration. Manage Patients, Appointments, Providers, Practices, Departments, Claims. Use when the user wants to interact with Athenahealth data.

Quality

69%

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

Quality

Content

63%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 a solid, command-driven integration guide with real error-recovery loops for connection states. Its main weaknesses are a padded marketing-style intro, a dangling 'Step 2' reference in the workflow, an empty Description column in the actions table, and no separation of the growing API-action reference material into a references file.

Suggestions

Delete or compress the three-sentence product background paragraph and merge the duplicated polling instructions into the state-handling section.

Fix the workflow numbering: either label the steps ('Step 1: connect', 'Step 2: search and run actions') that 'skip to Step 2' points to, or replace the reference with a section link.

Move the Popular actions table and proxy flags into a references/ file, and fill in the empty Description column plus one worked end-to-end example (e.g. listing patients with `list-patients` and reading its output).

DimensionReasoningScore

Conciseness

The body is mostly efficient command-first prose, but the opening product-marketing paragraph ('Athenahealth is a cloud-based platform providing... The platform aims to streamline operations and improve patient care'), the redundant second polling description ('After the user completes the action... poll again'), and the awkward 'Agent Types' aside are padding Claude doesn't need — anchor 3, not the lean anchor 5 nor the heavily padded anchor 2.

3 / 5

Actionability

Nearly every section gives copy-pasteable commands with flags (`npm install -g @membranehq/cli@latest`, `membrane connection ensure`, `membrane action run ... --input '{"key": "value"}'`, the proxy flags table), but `membrane connection ensure ""` leaves the key argument as an unexplained empty string, and the Popular actions table has an entirely empty Description column with no worked end-to-end example — concrete with minor gaps, anchor 4 rather than anchor 5.

4 / 5

Workflow Clarity

There is a clear sequence (install → login → connection ensure → poll states → search actions → run) with genuine feedback loops (CLIENT_ACTION_REQUIRED handling, re-poll after user action, CONFIGURATION_ERROR/SETUP_FAILED error checks), matching anchor 4's 'clear sequence with most checkpoints present'. It falls short of anchor 5 because 'skip to **Step 2**' references a step that is never labeled — the numbered flow breaks at section '1b' with no 'Step 1'/'Step 2' headers — and results of action runs are never validated.

4 / 5

Progressive Disclosure

The skill is a single ~150-line file with no bundle files at all; sections are well-headed, but inline reference material that clearly belongs in a separate file — the 13-row Popular actions table (with empty descriptions) and the proxy flags table — is monolithic in the body, fitting anchor 3 ('content that should be separate is inline') better than anchor 4.

3 / 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 is well-formed: it names a distinct product, lists six managed resources, uses third person, and includes an explicit 'Use when' clause. Its weaknesses are the single generic verb 'Manage' for all capabilities and a trigger clause that relies solely on the brand name with no synonyms like EHR, scheduling, or patient records.

Suggestions

Replace the generic verb 'Manage' with concrete per-resource actions, e.g. 'List, create, and update Patients; book and cancel Appointments; submit Claims'.

Expand the 'when' clause with natural trigger phrasings users would actually say, e.g. 'Use when the user mentions Athenahealth, EHR data, patient records, appointment scheduling, or medical claims'.

State what the integration operates on technically (e.g. athenahealth API via pre-built actions and a request proxy) so the 'what' is more concrete than 'Manage ... data'.

DimensionReasoningScore

Specificity

The single generic verb "Manage" is applied to six named resources ("Patients, Appointments, Providers, Practices, Departments, Claims"), so the domain and objects are concrete but the actions themselves remain generic — matching anchor 3's 'names domain and concrete actions but not comprehensive' better than anchor 2's minimal coverage, yet not anchor 4's 'several specific actions'.

3 / 5

Completeness

Both parts are present — a 'what' ("Manage Patients, Appointments, Providers, Practices, Departments, Claims") and an explicit 'when' ("Use when the user wants to interact with Athenahealth data") — but the 'when' is generic ('interact with ... data') and could be more specific, matching anchor 4 exactly rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

The only natural keyword is the brand "Athenahealth" (plus resource names like Patients/Appointments inside the capability list, not the trigger clause); common user phrasings such as "EHR", "patient records", or "appointment scheduling" are missing, fitting anchor 3 ('relevant keywords but missing common variations or synonyms').

3 / 5

Distinctiveness Conflict Risk

The "Athenahealth" brand carves a clear niche with minimal conflict risk against unrelated skills, but the trigger clause is broad enough ('interact with Athenahealth data') to overlap with a closely related healthcare/EHR skill, so anchor 4 fits better than anchor 5.

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