CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clockodo

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

Quality

65%

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/clockodo/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 delivers a concrete, executable Membrane CLI workflow with good connection-state validation checkpoints and well-organized single-file structure. Its weaknesses are modest fluff in the intro and best-practices prose, plus broken internal cross-references ('Step 2' doesn't exist, '1b' without '1a') and inconsistent CLI invocation that slightly undercut actionability.

Suggestions

Fix internal navigation: 'skip to Step 2' points to a non-existent section, and '1b' appears without a '1a' — renumber the connection steps coherently.

Trim the marketing/explanatory prose (intro paragraph about Clockodo's business use, 'focus on the integration logic', 'burn less tokens') to tighten token efficiency.

Standardize on one invocation form ('membrane' vs 'npx @membranehq/cli') and add a short note on handling action-run errors to close the validation loop.

DimensionReasoningScore

Conciseness

The body is mostly command-driven and efficient, but includes unnecessary explanation: the opening paragraph on what Clockodo is used for ('used by small to medium-sized businesses across various industries'), the marketing-flavored line about Membrane letting you 'focus on the integration logic rather than auth plumbing', and padded best-practice prose ('This will burn less tokens and make communication more secure'). Matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); anchor 4 would require only minor trims.

3 / 5

Actionability

Concrete, copy-paste-ready commands throughout — install ('npm install -g @membranehq/cli@latest'), login, connection ensure, polling with '--wait', 'action run <actionId> --input ...', plus a proxy flag table. Minor gaps keep it from 5: the dangling 'skip to Step 2' reference (no Step 2 exists), inconsistent 'membrane' vs 'npx @membranehq/cli' invocation, and '1b' numbering with no '1a'. Matches anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps').

4 / 5

Workflow Clarity

A clear sequence is present (install → login → connection ensure → poll until READY → discover actions → run/proxy) with explicit state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and re-poll guidance, which act as validation feedback loops for the connection step. Minor gaps: the broken 'Step 2' cross-reference and section numbering (1b without 1a), and no explicit validation guidance when action runs fail. Matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than 5, which would require error-recovery loops for action execution too.

4 / 5

Progressive Disclosure

The skill is a single SKILL.md (~150 lines) with no bundle files, and all content — CLI setup, connection lifecycle, action discovery, proxy usage — is one level deep and appropriately inlined for a single-workflow integration skill. Sections are clearly headed and navigable. This is 'good structure; most content is appropriately placed; references mostly clear; minor organization gaps' (anchor 4); the proxy flags table and connection-state details could arguably live in a reference file, and the numbering inconsistency ('1b', missing Step 2) is a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

48%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 names the target app and includes an explicit 'Use when' clause, but the capability description is generic ('manage data, records, and automate workflows') and the trigger terms are thin — missing natural vocabulary like time tracking, timesheets, and work hours that users of a time-tracking tool would say.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete actions, e.g. 'Create and edit time entries, manage customers, projects, services and tasks, pull reports and work-hour summaries'.

Expand trigger terms to include natural user vocabulary: 'Use when the user mentions Clockodo, time tracking, timesheets, or tracking work hours.'

Mention what Clockodo is (time tracking software) in one clause so the skill triggers even when the user describes the need without naming the app.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain (Clockodo) but the actions are generic — no concrete operations like create time entries, generate reports, or manage customers/projects. It matches anchor 2 ('names the domain but actions are minimal or generic'); anchor 3 would require 1-2 concrete actions, which are absent.

2 / 5

Completeness

A 'Use when...' clause is present ("Use when the user wants to interact with Clockodo data") so the cap of 3 for a missing trigger does not apply, but the 'what' is vague ('Manage data, records, and automate workflows') — the description answers 'when' explicitly yet only weakly answers 'what'. It sits between anchor 3 (what present but weak) and anchor 4 (both present, when could be more specific); the vague 'what' pulls it to 3.

3 / 5

Trigger Term Quality

"Use when the user wants to interact with Clockodo data" includes the natural keyword 'Clockodo', but misses the common phrases users would actually say — 'time tracking', 'timesheet', 'work hours', 'time entries'. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms').

3 / 5

Distinctiveness Conflict Risk

"Clockodo" is a distinctive app name with a clear niche ("interact with Clockodo data"), giving minimal conflict risk, but the generic phrases "Manage data, records, and automate workflows" could overlap with other data-management skills when the user doesn't name Clockodo. Matches anchor 4 ('mostly distinct; minor overlap risk with closely related skills'), not anchor 5 which requires distinct triggers throughout.

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