CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apaya

Apaya integration. Manage data, records, and automate workflows. Use when the user wants to interact with Apaya 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/apaya/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.

The body is a strong, action-oriented CLI guide: every step is an executable command, the connection lifecycle includes explicit state-based checkpoints and recovery guidance, and the proxy fallback is documented with a complete flag table. The main defects are small coherence issues — a dangling 'Step 2' reference, an orphan '1b' heading, and slightly padded intro/best-practice prose — plus the absence of a concrete end-to-end action example.

Suggestions

Fix the dangling step references: either label the sections as Step 1/1b/2 consistently or drop the 'skip to **Step 2**' phrasing entirely.

Add one concrete end-to-end example (a real action name, its --input JSON, and the shape of the `output` response) under 'Running actions'.

Trim the opener and 'Agent Types' line to factual statements, and merge 'Popular actions' into 'Searching for actions' to remove redundancy.

DimensionReasoningScore

Conciseness

The body is command-first and efficient — nearly every section is a copy-paste CLI invocation with only brief context. Minor over-explanation could be trimmed: the marketing-flavored opener ('reduce churn', 'focus on the integration logic rather than auth plumbing') and the loosely-written 'Agent Types' line add little. This fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than 5.

4 / 5

Actionability

Concrete, executable commands cover the full path (install, login, headless login completion, connection ensure/poll, action list/run with JSON input, proxy with a flag table). It falls short of 5 due to small gaps: 'skip to **Step 2**' references a step label that doesn't exist, and there is no end-to-end example with a real action id and output.

4 / 5

Workflow Clarity

The sequence (install → authenticate → connect → poll until READY → discover actions → run → proxy fallback) is clear, and the connection-state branching (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with follow-up polling) forms an explicit validation loop. Minor gaps remain: the broken 'Step 2' / '1b' numbering makes the sequence slightly incoherent, and there is no verification guidance for action run results.

4 / 5

Progressive Disclosure

No bundle files exist and none are referenced; all content is inline in one file with clear, well-ordered section headers. At ~140 lines the material is appropriately placed (connection lifecycle, discovery, execution, proxy options, best practices) with only minor organization gaps such as the stray 'Popular actions' heading and inconsistent step labels. Fits 'Good structure; most content is appropriately placed' rather than 5, since the content slightly exceeds a lean single-file overview.

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 has an explicit and appropriate 'Use when...' trigger clause and benefits from the distinctive 'Apaya' brand name, but its capability statement is vague. It never conveys that Apaya is a payments/subscriptions platform, so both the action list and the natural trigger vocabulary (billing, subscriptions, payments) are missing.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete payment-domain actions, e.g. 'Manage subscriptions, recurring billing, customers, and payment records in Apaya'.

Add natural trigger terms users would actually say, such as 'billing', 'payments', 'subscriptions', or 'recurring charges', to the 'Use when' clause.

State what Apaya is (a payment/subscription platform) in one phrase so the description is self-contained without reading the body.

DimensionReasoningScore

Specificity

The description names the domain ('Apaya integration') but the actions — 'Manage data, records, and automate workflows' — are entirely generic with no concrete payment-domain capabilities (e.g. subscriptions, recurring billing, refunds). This matches the anchor 'Names the domain but actions are minimal or generic'; it is not score 3 because no 1-2 concrete, domain-specific actions are listed.

2 / 5

Completeness

Both elements are present: a 'what' ('Manage data, records, and automate workflows') and an explicit trigger ('Use when the user wants to interact with Apaya data'). It does not reach 5 because the 'what' is generic rather than concrete; it is above 3 because the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

'Apaya' and 'interact with Apaya data' are relevant keywords a user would say, but the natural payment vocabulary (payments, billing, subscriptions, recurring charges) is entirely missing. Fits 'Some relevant keywords but missing common variations or synonyms' rather than score 2, since the domain keyword is present and specific.

3 / 5

Distinctiveness Conflict Risk

The 'Apaya' brand scoping gives a clear niche unlikely to fire for unrelated skills, but the generic tail 'Manage data, records, and automate workflows' could overlap with generic data-management skills. Fits 'Mostly distinct; minor overlap risk with closely related skills'; not 5 because the generic phrasing weakens the distinct trigger set.

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