CtrlK
BlogDocsLog inGet started
Tessl Logo

apify-integration-development

Design and build an official Apify integration for a company's product - workflow-automation apps (Zapier/n8n-style), AI agent plugins (coding-agent skills+MCP bundles or OpenClaw/Hermes-style harnesses), AI framework packages (LangChain/LlamaIndex-style), or direct application clients via apify-client. Use when planning, creating, or reviewing an integration that exposes Apify Actors, runs, datasets, or key-value stores inside another product.

75

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

92%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-architected skill body: concise domain-specific invariants, an explicit multi-step workflow with named validation and review checklists, and clean one-level-deep progressive disclosure to four verified reference files. The single weakness is that executable language-specific scaffolding lives in the references rather than as inline copy-paste examples.

Suggestions

Add one short inline copy-paste example (e.g. a minimal start-run-and-poll snippet in JS or Python) so the most common case is executable without opening a reference file, lifting actionability from 4 to 5.

Consider naming 1-2 more natural platform terms (Make, Pipedream, Haystack, Vercel AI SDK) in the description to broaden trigger-term coverage.

DimensionReasoningScore

Conciseness

The body is dense with Apify-specific knowledge Claude lacks — vocabulary mirroring, the bounded-polling invariant, the maxTotalChargeUsd/maxItems cost rule, attribution headers, and the non-idempotent POST /runs retry rule — with no padding of concepts Claude already knows; every section earns its place, matching the 5 anchor. It is not a 4 because there are no trimmable over-explanation passages.

5 / 5

Actionability

Guidance is concrete and specific — exact endpoint paths, the API surface table, exact header names and values (x-apify-integration-platform, x-apify-integration-ai-tool), exact cost-control field semantics — and the run-flow snippet is executable, matching the 4 anchor. It is not a 5 because full language-specific scaffolding code is deferred to the reference files rather than given as copy-paste-ready examples inline.

4 / 5

Workflow Clarity

The 'Working workflow' lays out a 6-step sequence with a required Step-0 prerequisite and an explicit validation checkpoint ('Verify against the definition-of-done checklist at the end of that reference'), supplemented by the 'Top anti-patterns to refuse on review' checklist, matching the 5 anchor's explicit validation and checklists. It is not a 4 because validation is explicitly named rather than merely implied.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview with a navigation table mapping each product shape to exactly one one-level-deep reference file, and all four referenced files (workflow-automation.md, ai-harness-plugin.md, ai-framework-package.md, sdk-integration.md) exist in references/, matching the 5 anchor. It is not a 4 because the split is clean and navigation is explicit, with no buried or nested references.

5 / 5

Total

19

/

20

Passed

Description

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

A strong, specific description that names every supported integration shape with example products and pairs a clear 'what' with an explicit 'Use when…' trigger clause in third-person voice. The only gap is trigger-term breadth: a few natural platform names that appear in the body are absent from the description itself.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete integration shapes — 'workflow-automation apps (Zapier/n8n-style), AI agent plugins (coding-agent skills+MCP bundles or OpenClaw/Hermes-style harnesses), AI framework packages (LangChain/LlamaIndex-style), or direct application clients via apify-client' — giving comprehensive coverage of the domain, matching the 5 anchor; it is not a 4 because coverage of all supported shapes is complete rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both 'what' ('Design and build an official Apify integration…') and 'when' with concrete trigger phrases ('Use when planning, creating, or reviewing an integration that exposes Apify Actors, runs, datasets, or key-value stores inside another product'), matching the 5 anchor; it is not a 4 because the 'when' clause is explicit and concrete rather than weakly implied.

5 / 5

Trigger Term Quality

Natural product keywords a partner would say are present (Zapier, n8n, LangChain, LlamaIndex, apify-client, Apify Actors/runs/datasets/key-value stores), but several natural terms that appear in the body (Make, Pipedream, Haystack, Vercel AI SDK) are missing from the description, so it sits at good-but-not-comprehensive coverage rather than 5.

4 / 5

Distinctiveness Conflict Risk

'official Apify integration for a company's product' with named host platforms carves a clear niche with distinct triggers and minimal conflict risk with other skills; it is not a 4 because the scope is unambiguous rather than having minor overlap risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
apify/agent-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.