CtrlK
BlogDocsLog inGet started
Tessl Logo

deputy

Deputy integration. Manage Employees, Locations, LeaveRequests, Timesheets, PayRates. Use when the user wants to interact with Deputy data.

60

Quality

71%

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/deputy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 highly actionable with executable Membrane CLI commands and a well-validated connection workflow. Weaknesses are an unnecessary background paragraph, a destructive proxy path lacking verification guidance (capping workflow clarity), and bulk inlined reference tables.

Suggestions

Add a verification step after destructive proxy/action calls, e.g. re-fetch the resource to confirm the change applied, to lift workflow clarity above the cap of 3.

Cut the opening 'Deputy is a workforce management platform...' paragraph and the filler line 'Use action names and parameters as needed.' to tighten conciseness.

Move the 30-item object list and/or Popular actions table into a reference file (e.g. references/objects.md) referenced one level deep, improving progressive disclosure.

DimensionReasoningScore

Conciseness

Mostly efficient CLI command blocks, but the opening 'Deputy is a workforce management platform that simplifies scheduling, time tracking, and communication for businesses with hourly workers...' is background fluff Claude does not need, and the 30+ item object bullet-list plus 'Use action names and parameters as needed.' add padding — matching 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not a 2 because the bulk is actionable commands rather than padded prose, not a 4 because the background paragraph and filler line should be cut.

3 / 5

Actionability

Copy-paste-ready executable commands throughout — 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://deputy.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input ...', plus a Popular actions table and proxy flag table — matching 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The connection workflow is well sequenced with validation (poll until state leaves BUILDING, branch on READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but the proxy path supports destructive HTTP methods ('-X, --method ... DELETE') and 'action run' with no verify/retry guidance; per the rubric cap, 'Missing validation/verification steps in workflows involving destructive or batch operations should cap workflow clarity at 3', so it cannot exceed 3 despite the strong connection sequence.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ all absent), so content lives in SKILL.md; sections are clearly headed (Overview, Working with Deputy, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices) and the skill delegates detail discovery to 'membrane action list --intent', matching 'Good structure; most content is appropriately placed; minor organization gaps'; not a 5 because the 30-item object list and 15-row actions table are bulk reference content inlined in the overview rather than split out.

4 / 5

Total

15

/

20

Passed

Description

73%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 cleanly states a Deputy-specific niche with both a 'what' (entity list) and an explicit 'use when' trigger. Its main weakness is the single generic verb 'Manage' covering all entities and a slightly broad 'when' clause.

Suggestions

Replace the generic 'Manage' with concrete per-entity verbs, e.g. 'Create and list Employees, Locations, LeaveRequests, Timesheets, and PayRates'.

Sharpen the trigger clause to concrete user phrasing, e.g. 'Use when the user wants to manage Deputy scheduling, timesheets, leave, or pay rates'.

Add commonly-used synonyms (scheduling, shifts, rosters) so the description matches how users actually ask.

DimensionReasoningScore

Specificity

Quotes 'Manage Employees, Locations, LeaveRequests, Timesheets, PayRates' — it names the Deputy domain and several concrete entity types, but the single generic verb 'Manage' applied to all of them is not a set of distinct concrete actions, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is not a 2 because the listed entities are themselves concrete capabilities, and not a 4 because no per-entity action verbs (create/list/update) are given.

3 / 5

Completeness

Both halves are present: 'what' = 'Deputy integration. Manage Employees, Locations, LeaveRequests, Timesheets, PayRates' and 'when' = 'Use when the user wants to interact with Deputy data', matching 'Has both what and when; when could be more explicit or specific'; not a 5 because the 'when' is a generic 'interact with Deputy data' rather than concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural Deputy terms appear — 'Employees, Locations, LeaveRequests, Timesheets, PayRates' and trigger clause 'Use when the user wants to interact with Deputy data' — giving good keyword coverage matching 'Good keyword coverage; a few natural terms missing'; it is not a 5 because common synonyms users say (scheduling, shifts, rosters, .csv export) are absent.

4 / 5

Distinctiveness Conflict Risk

'Deputy integration' tied to Deputy-specific entities (LeaveRequests, PayRates, Timesheets) carves a clear niche with minimal overlap risk against other skills, matching 'Clear niche with distinct triggers; minimal conflict risk'; not a 4 because the product name itself is highly distinguishing.

5 / 5

Total

16

/

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.