CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

calendso

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

Quality

66%

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/calendso/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 a solidly actionable single-file guide with concrete CLI commands, parameter examples, and a well-handled connection-state polling loop. Its main weaknesses are token waste (duplicated commands, marketing intro, filler lines), an empty "Popular actions" section, and broken step numbering ("Step 2" is referenced but never defined).

Suggestions

Remove the duplication: "Searching for actions" and "Popular actions" show the same `action list` command — keep one, and either populate "Popular actions" with a few concrete example actions (name + input) or delete the section.

Fix the step numbering: define Step 1/Step 2 explicitly (e.g. "Step 1: create the connection", "Step 2: search and run actions") or replace the "skip to Step 2" and "1b" references with section names.

Trim the marketing intro ("It's used by businesses and individuals to streamline booking...") and the filler line "Use action names and parameters as needed" — neither changes what the agent does.

DimensionReasoningScore

Conciseness

The body is mostly efficient command blocks, but contains unnecessary padding: a marketing-style intro ("It's used by businesses and individuals to streamline booking appointments, meetings, and events"), the filler line "Use action names and parameters as needed", the same `action list` command shown twice (once as `membrane`, once as `npx`), and a "Popular actions" section that lists no actions. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' — below 4 because the duplication and empty section are clearly trimmable.

3 / 5

Actionability

Concrete, copy-paste-ready CLI commands appear throughout (install, login, connection ensure, poll with --wait, action list/run with --input JSON, proxy flags table). Minor gaps keep it below 5: "skip to Step 2" references a step that is never defined, and the "Popular actions" heading contains no actual example actions with IDs or inputs.

4 / 5

Workflow Clarity

A clear sequence runs install → login → connection ensure → poll --wait → handle clientAction states → search actions → run → proxy fallback, with explicit state checkpoints (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR/SETUP_FAILED) and a re-poll feedback loop. Below 5 because the step numbering is incoherent — "1b" exists without a labeled Step 1, and "Step 2" is referenced twice but never defined.

4 / 5

Progressive Disclosure

As a single-file skill with no bundle files, content stays one level deep with clear section headers (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) — good structure with content appropriately placed. Below 5 due to minor organization gaps: the entity bullet list under "Calendso Overview" carries no purpose, and the empty "Popular actions" section adds navigation noise.

4 / 5

Total

15

/

20

Passed

Description

50%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 an explicit 'Use when' clause and a distinctive domain name, but the capability description is generic — 'manage data, records, and automate workflows' could describe almost any integration. It lacks the scheduling-specific actions and natural trigger terms (booking, appointments, scheduling, meetings) that would make it discoverable and informative.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete actions, e.g. "Book meetings, manage availability and working hours, create event types, manage bookings, users, teams, and webhooks".

Add natural trigger terms and synonyms users would actually say: "Use when the user mentions Calendso, scheduling, booking appointments, setting availability, or Cal.com".

Mention common entities by name (bookings, event types, availability, calendars) so the description doubles as a coverage map of the integration.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Calendso domain but the actions are generic; no concrete capabilities like booking, availability, or event-type management are listed. This matches the anchor 'Names the domain but actions are minimal or generic' — above 1 because the domain is named, below 3 because no specific concrete action is described.

2 / 5

Completeness

Both parts are present: what ("Calendso integration. Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Calendso data"). It is above 3 because the 'when' is explicitly stated rather than missing, but below 5 because both the what and when remain generic and could be more specific with concrete trigger phrases.

4 / 5

Trigger Term Quality

The only natural keyword is "Calendso" (repeated); phrases like "manage data, records" and "automate workflows" are generic. Users would naturally say "scheduling", "booking", "appointments", "meetings", or "Cal.com" — none appear, matching 'One or two generic keywords; missing the natural phrases users say'.

2 / 5

Distinctiveness Conflict Risk

The Calendso name gives it a clear, distinct niche and the trigger explicitly names Calendso, so it is unlikely to fire for the wrong skill. Below 5 because the generic middle sentence ("Manage data, records, and automate workflows") creates minor overlap risk with other data-integration skills.

4 / 5

Total

12

/

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