Name: adp-workforce
Rating: 64 (1 reviews)
Author: membranedev

adp-workforce

ADP Workforce Now integration. Manage Persons, Organizations, Jobs, Payrolls, Benefitses, Talents. Use when the user wants to interact with ADP Workforce Now data.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/adp-workforce/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid integration skill with excellent actionability—every step has executable CLI commands with clear parameters. The workflow for connection setup is well-structured with explicit state handling and error recovery. The main weaknesses are the unnecessary introductory explanation of ADP Workforce Now and the large inline actions table that could benefit from being in a separate reference file.

Suggestions

Remove the opening paragraph explaining what ADP Workforce Now is—Claude already knows this, and the skill description covers it.

Move the 'Popular actions' table to a separate ACTIONS.md reference file and link to it, keeping SKILL.md leaner.

Remove or collapse the 'ADP Workforce Now Overview' bullet list, which is disconnected from the actual workflow and adds no actionable value.

Dimension	Reasoning	Score
Conciseness	The opening paragraph explaining what ADP Workforce Now is (HCM platform, payroll, HR, etc.) is unnecessary context Claude already knows. The overview bullet list adds little value. However, the CLI commands and action tables are reasonably efficient.	2 / 3
Actionability	The skill provides fully executable CLI commands for every step: installation, authentication, connection setup, action discovery, action execution, and proxy requests. Commands are copy-paste ready with clear parameter placeholders and flag descriptions.	3 / 3
Workflow Clarity	The connection workflow is clearly sequenced (ensure → check state → wait if BUILDING → handle CLIENT_ACTION_REQUIRED → proceed when READY) with explicit state-based branching and error states. The headless auth flow includes a clear feedback loop (login → get code → complete).	3 / 3
Progressive Disclosure	The content is reasonably structured with clear sections, but the popular actions table is quite long and could be in a separate reference file. The ADP Workforce Now Overview bullet list is disconnected from the rest of the content and adds no navigational value. No bundle files exist to offload reference material.	2 / 3
	Total	10 / 12 Passed

Description

75%

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 effectively identifies a clear niche (ADP Workforce Now integration) and includes an explicit 'Use when' clause, making it complete and distinctive. However, it lacks specificity in the actions it can perform (only says 'Manage') and could benefit from more natural trigger terms that users might actually say. The typo 'Benefitses' also undermines quality.

Suggestions

Replace the vague 'Manage' with specific actions like 'Create, update, look up, and delete' to improve specificity.

Add common user trigger terms such as 'ADP', 'HR system', 'employee records', 'payroll data', 'benefits enrollment' to improve discoverability.

Fix the typo 'Benefitses' to 'Benefits'.

Dimension	Reasoning	Score
Specificity	It names the domain (ADP Workforce Now) and lists entity types (Persons, Organizations, Jobs, Payrolls, Benefits, Talents), but doesn't describe concrete actions beyond the vague 'Manage'. It doesn't specify what operations can be performed (e.g., create, update, lookup, sync).	2 / 3
Completeness	It answers both 'what' (manage Persons, Organizations, Jobs, Payrolls, Benefits, Talents in ADP Workforce Now) and 'when' ('Use when the user wants to interact with ADP Workforce Now data'), with an explicit trigger clause.	3 / 3
Trigger Term Quality	Includes 'ADP Workforce Now' which is a strong trigger term, and entity names like 'Payrolls', 'Jobs', 'Persons' are somewhat natural. However, it misses common user variations like 'ADP', 'payroll system', 'HR system', 'employee data', 'workforce management', or 'benefits enrollment'.	2 / 3
Distinctiveness Conflict Risk	ADP Workforce Now is a very specific product/platform, making this highly distinctive and unlikely to conflict with other skills. The niche is clear and well-defined.	3 / 3
	Total	10 / 12 Passed

Validation

90%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: membranedev/application-skills
Path: skills/adp-workforce/SKILL.md
Commit: f484c82

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.