CtrlK
BlogDocsLog inGet started
Tessl Logo

smartrecruiters

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

56

Quality

64%

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/smartrecruiters/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 strong executable guidance with a well-structured connection workflow that includes state-handling and feedback loops, though it is held back by a low-value cryptic overview section and inconsistent step numbering.

Suggestions

Replace the cryptic 'SmartRecruiters Overview' (Job/Applicants/Applicant) with a concrete one-line quick-start or remove it.

Fix the broken step references — label an explicit 'Step 1' so 'skip to Step 2' and '1b' resolve correctly.

Trim the introductory paragraph describing what SmartRecruiters is, since it largely restates platform knowledge Claude already has.

DimensionReasoningScore

Conciseness

Most of the body is efficient executable commands with brief explanations, but the opening platform-summary paragraph and the cryptic 'SmartRecruiters Overview' section ('Job / Applicants / Applicant... Use action names and parameters as needed') add explanation and padding that could be tightened, matching 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

Provides copy-paste-ready commands for install, auth, connection ensure, action list/run, and proxy with a clear options table, matching 'mostly executable guidance with minor gaps'; the gaps are placeholder values (CONNECTION_ID, actionId) and the absence of a concrete worked end-to-end example.

4 / 5

Workflow Clarity

The connection flow has a clear sequence with explicit state checkpoints and feedback loops (poll until READY, handle CLIENT_ACTION_REQUIRED then re-poll, check error states), matching 'clear sequence with most checkpoints present'; minor gaps are the broken step numbering ('Step 2'/'1b' without a labeled Step 1) and no validation guidance for proxy/action runs.

4 / 5

Progressive Disclosure

Content is organized into clear, well-signaled sections (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) in a single file with no nested references, matching 'good structure, most content appropriately placed, minor organization gaps'; the cryptic Overview section is the main organization gap.

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 names the target platform and includes an explicit 'Use when' trigger, but its capability list is generic ('manage data, records, automate workflows') and lacks the domain-specific task terms (hiring, applicants, recruiting) that would make triggers more natural and specific.

Suggestions

Replace generic verbs with concrete SmartRecruiters actions, e.g. 'Search candidates, manage job postings, and track applicants'.

Expand the 'Use when' clause with natural user phrases such as 'hiring', 'recruiting', 'candidates', or 'job applicants'.

Tighten the 'what' so it distinguishes data management from workflow automation with one or two specific examples.

DimensionReasoningScore

Specificity

Names the SmartRecruiters domain but the listed actions ('Manage data, records, and automate workflows') are generic verbs rather than concrete capabilities, fitting the 'names domain, actions minimal or generic' anchor and falling short of the 'concrete actions' required for a 3.

2 / 5

Completeness

Both 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with SmartRecruiters data') are present, matching the 'has both what and when, when could be more explicit' anchor rather than the fully concrete trigger phrases needed for a 5.

4 / 5

Trigger Term Quality

The trigger phrase 'Use when the user wants to interact with SmartRecruiters data' surfaces the product name as a keyword, but it omits the natural task terms a user would say (hiring, recruiting, candidates, job postings, applicants), so coverage has relevant keywords but is missing common variations.

3 / 5

Distinctiveness Conflict Risk

Naming a specific named platform (SmartRecruiters) gives it a clear niche with distinct triggers and minimal conflict risk with other skills, matching 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.

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