CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

acumatica-webhooks

Receive and authenticate Acumatica push notification webhooks. Use when setting up an Acumatica (MYOB Acumatica) Webhook destination on the Push Notifications form, checking the secret header you configured, debugging 401s, or handling Inserted and Deleted row changes from a monitored generic inquiry.

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 an efficient, highly actionable reference for a single-purpose skill: correct executable verification code, exact env vars, provider-specific payload and retry semantics, and real one-level-deep reference files. Weaknesses are minor: the handler workflow is implicit rather than an explicit step sequence, the examples/ links point at directories missing from the bundle, and the closing related-skills/attribution sections pad the token budget.

Suggestions

Fix or remove the dead examples/ links (examples/express/, examples/nextjs/, examples/fastapi/) and the Resources entry 'examples/ - Runnable... handlers with tests', since none of these paths exist in the bundle.

Replace the implicit ordering in 'Verification (core)' with an explicit numbered handler sequence (read raw -> authenticate -> parse -> dedupe on Id -> reply 200) so the workflow's checkpoints are unmistakable.

Trim the 10-item 'Related Skills' list and the 'Recommended' section's four sub-links down to one or two most-relevant pointers to reclaim tokens.

DimensionReasoningScore

Conciseness

The body is dense with provider-specific facts Claude cannot know (unsigned requests, configurable Header Name/Value, payload fields, retry/dedupe behavior) and avoids explaining generic concepts, matching 'efficient; minor instances of over-explanation that could be trimmed'. The trimmable parts are the 10-link 'Related Skills' list, the 4-link 'Recommended' section, and the Attribution block, which spend tokens on cross-promotion rather than the task.

4 / 5

Actionability

The guidance is fully executable: a complete, correct Node verification function (including the timingSafeEqual unequal-length guard), exact env-var definitions with example values, a copy-paste Hookdeck CLI tunnel command, explicit 401/400/200 status-code rules, and the 'express.raw({ type: '*/*' })' body-reading instruction. This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

A clear implicit sequence is present with checkpoints — read the body raw, 'authenticate before parsing it', return 401/400/200 at the right points, reply 200 and dedupe on Id — plus a security caveat and rotation guidance. It falls short of the score-5 anchor because the handler sequence is never laid out as explicit ordered steps with error-recovery loops; the body defers that to the external webhook-handler-patterns skill and examples/ directories.

4 / 5

Progressive Disclosure

The body is a genuine overview with well-signaled, one-level-deep references (references/overview.md, setup.md, verification.md) that all exist and are described in the Resources section. It misses score 5 because the body links to examples/express/, examples/nextjs/, examples/fastapi/ and 'examples/ - Runnable... handlers with tests' which are not present in the bundle, leaving several dead navigation paths.

4 / 5

Total

17

/

20

Passed

Description

100%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 is a strong example: third-person voice, concrete multi-action 'what', an explicit 'Use when' clause with provider-specific triggers including the MYOB synonym, and a distinct niche that minimizes conflict with sibling webhook skills. No changes needed.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Receive and authenticate Acumatica push notification webhooks', 'setting up an Acumatica (MYOB Acumatica) Webhook destination', 'checking the secret header you configured', 'debugging 401s', 'handling Inserted and Deleted row changes' — comprehensively covering the skill's scope. This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor which expects minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is 'Receive and authenticate Acumatica push notification webhooks' and the 'when' is an explicit 'Use when setting up... checking... debugging 401s, or handling Inserted and Deleted row changes' clause with concrete trigger phrases. This mirrors the score-5 good example structure (what + explicit 'Use when' with triggers).

5 / 5

Trigger Term Quality

Natural trigger terms include 'Acumatica', 'MYOB Acumatica' (a synonym users actually use), 'webhooks', 'push notification', 'Webhook destination', 'Push Notifications form', '401s', and 'Inserted and Deleted' — the vocabulary a user with this need would naturally say. Coverage is comprehensive including the vendor synonym; no relevant natural phrasing is missing for this niche.

5 / 5

Distinctiveness Conflict Risk

The Acumatica/MYOB Acumatica ERP niche is highly distinct with provider-specific triggers (Push Notifications form, generic inquiry, Inserted/Deleted arrays), so it is unlikely to fire for any other webhook skill. This is a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

hookdeck/webhook-skills

Path

skills/acumatica-webhooks/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.