CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

altera-payroll

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

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/altera-payroll/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A well-structured, command-driven integration guide that is mostly executable and lean, with genuine state-handling feedback loops. Its main flaws are small: inconsistent step numbering ('Step 2', '1b'), a near-empty 'Popular actions' section duplicating the search command, and no concrete worked example of an action invocation.

Suggestions

Fix the workflow numbering in 'Connecting to Altera Payroll': label the initial 'connection ensure' step as 1a and add an explicit 'Step 2' heading (e.g., 'Searching for actions'), or replace the 'skip to Step 2' references with section links so the sequence is unambiguous.

Replace the 'Popular actions' section (which only repeats the search command) with a concrete worked example, e.g. membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"employeeId": "..."}' --json, and pick one invocation style (membrane vs npx @membranehq/cli@latest) throughout.

DimensionReasoningScore

Conciseness

The body is dominated by concrete commands, a compact flags table, and terse state descriptions, with only minor over-explanation such as 'This is the fastest way to get a connection' and the padded best-practice note 'This will burn less tokens and make communication more secure'. It fits the 'efficient; minor instances of over-explanation that could be trimmed' anchor, not 5 because a few editorial sentences and the redundant 'Popular actions' line don't earn their tokens.

4 / 5

Actionability

Nearly all guidance is copy-paste executable ('npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://alterapayroll.com/" --json', "membrane action run <actionId> --input '{\"key\": \"value\"}' --json") with a flags table for proxy options. It falls short of 5 due to minor gaps: no worked example of a real action id or --intent value, and inconsistent invocation ('npx @membranehq/cli@latest action list' vs 'membrane action list').

4 / 5

Workflow Clarity

The sequence install → login → connect → poll state → search → run → proxy is clear, and the connection lifecycle includes a real feedback loop (poll with '--wait' until not BUILDING, handle CLIENT_ACTION_REQUIRED, 'poll again ... to check if the state moved to READY'). Not 5 because the step references are broken: 'skip to **Step 2**' and '#### 1b. Wait for the connection' exist with no labeled Step 1a or Step 2 heading, leaving the reader to infer what Step 2 is.

4 / 5

Progressive Disclosure

The single-file body is well sectioned (Overview, Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no nested or buried references since no bundle files exist. It sits at the 'good structure; most content appropriately placed; minor organization gaps' anchor rather than 5 because the connection state-machine detail and proxy flag table could be split into reference files, and the 'Popular actions' section merely repeats the search command.

4 / 5

Total

16

/

20

Passed

Description

57%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 answers both what and when and is anchored by a distinctive product name, but its capability statement is generic ('manage data, records, automate workflows') and it lacks the natural payroll vocabulary users would say. It is serviceable for triggering but undersells the skill's concrete capabilities.

Suggestions

Replace the generic action phrase with concrete payroll operations, e.g. 'Run payroll, view paychecks and pay runs, manage employee records, and pull tax and company reports.'

Add natural trigger vocabulary users would actually say — 'payroll', 'paychecks', 'pay runs', 'employee payments', 'taxes' — to the 'Use when' clause, e.g. 'Use when the user wants to interact with Altera Payroll data — payroll runs, paychecks, employees, taxes, or reports.'

DimensionReasoningScore

Specificity

The description names the domain ('Altera Payroll integration') but its actions — 'Manage data, records, and automate workflows' — are generic with no concrete payroll operations (e.g., run payroll, view paychecks, handle taxes). This matches the anchor 'Names the domain but actions are minimal or generic'; it is above 1 because the domain is explicitly named, and below 3 because no specific action verb appears.

2 / 5

Completeness

It has both a 'what' ('Altera Payroll integration. Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Altera Payroll data'). Matches the anchor 'Has both what and when; when could be more explicit or specific' — the when clause is present but narrow, and the what is thin on concrete capabilities, keeping it below 5.

4 / 5

Trigger Term Quality

'Altera Payroll' (twice) and 'interact with Altera Payroll data' are relevant natural keywords, but common variations a user would say are missing: 'payroll', 'paycheck', 'pay run', 'employee payments', 'taxes'. This fits the 'some relevant keywords but missing common variations or synonyms' anchor, not 4 because the only distinctive trigger is the product name.

3 / 5

Distinctiveness Conflict Risk

The product name 'Altera Payroll' is a distinct trigger that clearly separates it from generic data skills, fitting 'mostly distinct; minor overlap risk with closely related skills' — sibling skills from the same Altera HR suite (suggested by help.alterahr.com) could compete, and the phrase 'Manage data, records, and automate workflows' is broad. Not 5 because of that residual overlap; not 3 because the named-product trigger is much stronger than 'Works with document files'.

4 / 5

Total

13

/

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/altera-payroll/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.