CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

acuity-scheduling

Acuity Scheduling integration. Manage Calendars, Clients, Users, Forms, Packages, Coupons. Use when the user wants to interact with Acuity Scheduling data.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%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.

A highly actionable, well-structured CLI integration guide whose commands are uniformly copy-paste ready. Its main weaknesses are workflow polish — a dangling 'Step 2' reference, inconsistent CLI invocation, and no validation guidance for the destructive actions it exposes — and a single-file layout with a sizable inline action reference rather than progressive disclosure.

Suggestions

Add validation/verification steps for destructive actions (Cancel Appointment, Delete Client, Delete Block): e.g., run get-appointment/get-client to confirm the target, then confirm with the user before running delete/cancel, and verify the result afterward.

Fix the broken cross-references and inconsistent commands: either label the next section 'Step 2' or reword to 'skip to Searching for actions', and use the same invocation form for `connection get` (`membrane` vs `npx @membranehq/cli`).

Consider moving the Popular actions table (and the detailed connection-state semantics) into a references/ file so SKILL.md stays a lean overview with one-level-deep, clearly signaled pointers.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands and compact tables, with only minor trimmable filler ("Use action names and parameters as needed.", the intro sentence about salons/therapists/consultants, and the awkward "Agent Types" aside). This fits 'efficient; minor instances of over-explanation that could be trimmed' better than score 3, since the unnecessary material is only a few short lines across ~180 lines.

4 / 5

Actionability

Every stage has copy-paste-ready commands: `npm install -g @membranehq/cli@latest`, `membrane login complete <code>`, `membrane connection ensure "https://www.acuityscheduling.com/" --json`, `membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json`, and `membrane action run <actionId> --input '{"key": "value"}' --json`, plus a 20-row popular-actions table and a proxy fallback with a full flag table. Fully executable guidance covering the common cases — matches the anchor 5 example; nothing significant is missing for score 4.

5 / 5

Workflow Clarity

The connection workflow has a clear sequence with genuine feedback loops (poll `--wait` while BUILDING, handle `clientAction`, re-poll after user auth, check `error` on CONFIGURATION_ERROR/SETUP_FAILED). However, "If the returned connection has `state: "READY"`, skip to **Step 2**" references a step label that doesn't exist, the heading "1b" belongs to a numbering scheme never established, and `membrane connection get` vs `npx @membranehq/cli connection get` are used inconsistently. Most importantly, destructive operations in the actions table (Cancel Appointment, Delete Client, Delete Block) have no validation/verification steps, which per the rubric caps this dimension at 3.

3 / 5

Progressive Disclosure

This is a single-file skill with no bundle files present; sections are well-organized (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) and easy to navigate. The ~20-row Popular actions table and the detailed connection-state handling are inline reference material that could move to a separate file, which keeps it below anchor 5, but placement is defensible for a CLI skill of this size — matching 'good structure; most content is appropriately placed; minor organization gaps' (4) rather than 'content that should be separate is inline' (3).

4 / 5

Total

16

/

20

Passed

Description

78%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.

A solid description that names the app, lists six concrete managed resources, and includes an explicit 'Use when' clause. Its main gap is that the trigger vocabulary and capability list omit the appointment/booking domain entirely — the app's core function — making both the 'what' and 'when' less comprehensive than they could be.

Suggestions

Mention appointment-centric capabilities, e.g. "Manage appointments, bookings, Calendars, Clients, Users, Forms, Packages, Coupons" — appointments are Acuity's core function and are currently absent from both the capability list and trigger terms.

Strengthen the 'when' clause with concrete trigger phrases instead of restating the app name, e.g. "Use when the user wants to schedule, reschedule, or cancel appointments, manage clients, or work with Acuity Scheduling data."

DimensionReasoningScore

Specificity

"Manage Calendars, Clients, Users, Forms, Packages, Coupons" enumerates six concrete resource capabilities, which goes beyond anchor 3's '1-2 concrete actions', but the coverage gap is larger than 'minor' — it omits appointments/booking, the app's core function (the body itself lists Appointment, Appointment Type, Class, Gift Certificate, Subscription, Report). Falls between anchors 3 and 4, noticeably above the midpoint.

4 / 5

Completeness

Both parts are present: the what ("Acuity Scheduling integration. Manage Calendars, Clients, Users, Forms, Packages, Coupons.") and an explicit when ("Use when the user wants to interact with Acuity Scheduling data."). The when clause is explicit but circular — it restates the app name rather than giving concrete trigger phrases like 'appointments' or 'bookings', so it matches anchor 4 ('when' could be more explicit or specific) rather than anchor 5.

4 / 5

Trigger Term Quality

Good keyword coverage: "Acuity Scheduling" (the strongest natural trigger), plus "Calendars", "Clients", "Users", "Forms", "Packages", "Coupons". However, it misses the most natural phrases a user would say — "appointments", "bookings", "reschedule", "availability" — keeping it below anchor 5's 'comprehensive coverage including synonyms'.

4 / 5

Distinctiveness Conflict Risk

"Acuity Scheduling integration" and "interact with Acuity Scheduling data" are anchored to a specific named app, giving a clear niche with distinct triggers and minimal conflict risk — even though generic words like Calendars/Clients appear, they are framed entirely within the Acuity context, so overlap with calendar or CRM skills is minimal.

5 / 5

Total

17

/

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/acuity-scheduling/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.