CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

appointedd

Appointedd integration. Manage data, records, and automate workflows. Use when the user wants to interact with Appointedd 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

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/appointedd/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 body is a solid, command-driven integration guide with a genuinely good connection-state workflow, but it wastes tokens on marketing prose and an empty table column, references a nonexistent Step 2, and lacks validation guidance for the destructive actions it advertises. Tightening the prose and adding error/confirmation handling for deletes and cancels would move it up a full band.

Suggestions

Cut the marketing sentences about who uses Appointedd and either populate or drop the empty Description column in the Popular actions table.

Fix the dangling "skip to Step 2" references by numbering the actual sections (e.g. make "Searching for actions" Step 2).

Add validation guidance for destructive operations (Delete Customer, Delete Reservation, Cancel Booking), such as confirming with the user or verifying the record before running the action.

Show one Appointedd-specific run example with real inputs (e.g. create-booking with service/customer IDs) so the common cases are fully covered.

DimensionReasoningScore

Conciseness

The body is mostly efficient command-first documentation, but it carries padding: the marketing sentence "It's used by a variety of businesses, from small independent service providers to larger enterprises, to streamline their scheduling processes and improve customer experience" adds nothing actionable, and the 16-row Popular actions table has an entirely empty Description column. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not a 4 because the empty-column table and fluff paragraph are noticeable waste.

3 / 5

Actionability

Commands are concrete and copy-paste ready ("npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://www.appointedd.com/\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json") with a complete proxy flag table. This matches 'mostly executable guidance; concrete code or commands with minor gaps'; not a 5 because no Appointedd-specific example shows real inputs for common cases such as create-booking or list-customers — the run examples stay generic placeholders.

4 / 5

Workflow Clarity

The connect flow is well sequenced with a state machine and feedback loops (poll with --wait, handle CLIENT_ACTION_REQUIRED, "poll again... to check if the state moved to READY"), but the body twice says "skip to Step 2" with no Step 2 heading existing, and the skill advertises destructive actions (Delete Customer, Delete Reservation, Cancel Booking) with no validation or confirmation guidance — the rubric caps destructive workflows without validation at 3. Not a 2 because the sequence itself is coherent and largely checkpointed.

3 / 5

Progressive Disclosure

No bundle files exist, and the ~160-line body is well organized under clear headers (install, auth, connect, search, run, proxy, best practices), matching 'good structure; most content is appropriately placed; minor organization gaps'. Not a 5 because it exceeds the simple-skill threshold and inlines a 16-row action catalog that would fit better in a reference file.

4 / 5

Total

14

/

20

Passed

Description

61%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 a strong, distinctive brand trigger and an explicit 'Use when' clause, but its capability statement is generic. Naming the actual objects (bookings, customers, services, resources, appointments) would lift both specificity and trigger-term quality substantially.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete capabilities, e.g. "Create, update, and cancel bookings; manage customers, services, and resources; check availability".

Add natural trigger terms users would say, such as appointments, bookings, scheduling, reservations, or customers, to the 'Use when' clause.

State the when-condition in user-task language ("Use when the user wants to book, reschedule, or cancel appointments or manage Appointedd customer/booking data") instead of the circular "interact with Appointedd data".

DimensionReasoningScore

Specificity

The domain is named ("Appointedd integration") but the actions are generic — "Manage data, records, and automate workflows" names no concrete capabilities such as bookings, customers, services, or appointments, matching the 'names the domain but actions are minimal or generic' anchor. It is not a 3 because no concrete, specific action is listed anywhere in the description.

2 / 5

Completeness

Both halves are present: the 'what' ("Manage data, records, and automate workflows") and an explicit 'when' ("Use when the user wants to interact with Appointedd data"), matching 'has both what and when; when could be more explicit or specific'. Not a 3 because the when clause is explicit rather than weakly implied; not a 5 because neither half uses concrete trigger phrases like bookings or appointments.

4 / 5

Trigger Term Quality

"Appointedd" is a relevant, specific keyword, but every natural phrase a user would actually say — appointments, bookings, scheduling, reservations, customers — is absent. This matches 'some relevant keywords but missing common variations or synonyms'; not a 2 because the brand keyword is specific and genuinely triggering rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

"Appointedd" is a niche product name that serves as a clear, distinct trigger with minimal conflict risk against other skills — the description would not fire for the wrong skill. This matches the 'clear niche with distinct triggers' anchor.

5 / 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/appointedd/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.