CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clockwork-recruiting

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

Quality

70%

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/clockwork-recruiting/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 solid, highly actionable CLI integration guide: concrete commands, a state-machine-driven connection workflow with polling and re-auth feedback loops, and a useful proxy fallback with a full options table. Weaknesses are moderate redundancy (duplicated discovery command, an empty 'Popular actions' section, a dangling 'Step 2' reference) and an intro paragraph that explains context Claude does not strictly need.

Suggestions

Populate 'Popular actions' with a handful of real action ids for the core entities (candidates, jobs, tasks) or remove the heading and keep a single action-discovery section.

Fix the dangling 'skip to **Step 2**' reference by numbering the workflow steps explicitly (1. Connect, 2. Discover actions, 3. Run or proxy).

Trim the ATS explainer paragraph and the duplicated 'action list' command, and tighten the Best practices commentary to bare imperative rules.

DimensionReasoningScore

Conciseness

The body is mostly lean commands, but includes removable padding: an intro paragraph explaining what an ATS is ('an applicant tracking system (ATS) used by HR departments...'), the same action-list command shown twice ('membrane action list --intent' in 'Searching for actions' and 'npx @membranehq/cli@latest action list --intent' in 'Popular actions'), and rationale commentary ('This will burn less tokens and make communication more secure'). This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, since the redundancy goes beyond minor trimming.

3 / 5

Actionability

Nearly every section gives copy-paste executable commands: 'npm install -g @membranehq/cli@latest', 'membrane login --tenant --clientName=<agentType>', 'membrane connection ensure "https://www.clockworkrecruiting.com/" --json', 'membrane action run <actionId> --connectionId=... --input ...', plus a complete proxy options table. It stops short of anchor 5 because the 'Popular actions' section lists no actual action ids and no concrete end-to-end example for a common Clockwork Recruiting use case is shown.

4 / 5

Workflow Clarity

The setup sequence is clear with explicit state-based checkpoints: poll with '--wait' until state leaves 'BUILDING', handle 'CLIENT_ACTION_REQUIRED' via a feedback loop ('After the user completes the action... poll again'), and check the 'error' field on 'CONFIGURATION_ERROR'/'SETUP_FAILED'. It is not anchor 5 because the instructions say 'skip to **Step 2**' yet no step is ever labeled Step 2 and the overall sequence is not numbered, leaving minor sequencing ambiguity.

4 / 5

Progressive Disclosure

The single-file skill is well organized with clear headed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) and no nested references, with bulk API detail delegated to dynamic CLI discovery rather than inlined. Minor gaps — the underdeveloped 'Popular actions' section and the duplicated command — keep it at anchor 4 rather than 5.

4 / 5

Total

15

/

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 correctly uses third person, is concise, and has an explicit 'Use when' clause tied to a distinctive app name, giving it low conflict risk. Its main weakness is generic capability language — 'manage data, records, and automate workflows' could describe almost any integration — and it omits the natural recruiting-domain vocabulary (candidates, jobs, applications, hiring, ATS) that would improve triggering.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete ATS actions, e.g. 'Manage candidates, job postings, applications, tasks, and reports in Clockwork Recruiting'.

Broaden the 'Use when' clause to include natural trigger phrases such as recruiting, hiring, applicants, job postings, or ATS, not just 'interact with Clockwork Recruiting data'.

Mention the primary entities (candidates, jobs, tasks, reports) so users referring to those concepts can surface the skill even without naming the app.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain but the actions are entirely generic; no ATS-specific actions like managing job postings, candidate applications, or hiring pipelines are mentioned. It matches the anchor 'Names the domain but actions are minimal or generic' and falls below the level-3 anchor because not even 1-2 concrete actions are stated.

2 / 5

Completeness

Both 'what' ("Manage data, records, and automate workflows") and an explicit 'when' ("Use when the user wants to interact with Clockwork Recruiting data") are present. It does not reach anchor 5 because the 'what' is vague and the 'when' covers only 'data' interaction rather than concrete trigger phrases.

4 / 5

Trigger Term Quality

"Clockwork Recruiting" is the primary natural trigger and "data"/"records" add some relevance, but common phrases users would actually say are missing: recruiting, hiring, candidates, applicants, job postings, ATS. Anchor 3 ('some relevant keywords but missing common variations or synonyms') fits; it is above anchor 2 because the distinctive app name itself is a strong natural keyword.

3 / 5

Distinctiveness Conflict Risk

The named niche application 'Clockwork Recruiting' gives it a clear niche with distinct triggers and minimal conflict risk with other skills — a user naming this app unambiguously selects this skill.

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/clockwork-recruiting/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.