CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apify-actor-development

Create, modify, debug, and deploy Apify Actors, and write their input and output schemas. Use when building an Actor from scratch, changing or troubleshooting Actor code, generating or updating .actor schema files, or pushing an Actor to the Apify platform. To wrap an existing non-Actor project, use apify-actorization instead.

Quality

94%

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

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

An exceptionally well-constructed skill body: lean, copy-paste-ready, bilingual (JS/TS and Python) examples, and clean one-level-deep disclosure into six real reference files. The single weakness is the absence of explicit fix-and-retry loops around the validation steps it already defines.

DimensionReasoningScore

Conciseness

The body is dense and command-driven with essentially no padding: a two-sentence domain intro, a template-selection table, terse rules, and bare command blocks. It assumes competence (e.g. "Skip the steps that do not apply when modifying an existing Actor") and never explains concepts Claude already knows; detail is pushed to references/. The repeated --user-agent flag is copy-paste-serving, not verbosity.

5 / 5

Actionability

Every step is executable: exact CLI commands (`apify create <actor-name> -t <template-id>`), a concrete template matrix, copy-paste aborting handlers in both JS/TS (`Actor.on('aborting', async () => {...})`) and Python, proxy-setup calls per language, and charge/limit-check calls. Specific examples cover the common cases.

5 / 5

Workflow Clarity

The 9-step workflow is clearly sequenced with an explicit completion criterion on nearly every step ("Done when <name>/.actor/actor.json exists", "Done when the run ends with status SUCCEEDED") plus validation commands (`apify validate-schema`, local `apify run` before `apify push`, user confirmation before deploy). However, no explicit error-recovery feedback loops are written (no "if validation fails, fix and re-run" guidance), which the 5 anchor requires — it fits the 4 anchor with only that gap.

4 / 5

Progressive Disclosure

SKILL.md is a true overview: schema authoring, actor.json, standby mode, logging, and README guidelines are each one well-signaled markdown link away (references/input-schema.md, output-schemas.md, actor-json.md, standby-mode.md, logging.md, actor-readme.md — all verified to exist), one level deep, with bulk detail correctly out of the main file. Navigation is easy and every section earns its tokens.

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.

The description is a strong exemplar: concrete lifecycle verbs, an explicit multi-trigger 'Use when' clause, and proactive disambiguation against a related skill. The only minor gap is a handful of natural synonyms a user might say (crawler/scraper phrasings) beyond 'Actor'.

DimensionReasoningScore

Specificity

"Create, modify, debug, and deploy Apify Actors, and write their input and output schemas" lists multiple specific concrete actions covering the full lifecycle (build, change, troubleshoot, deploy, schema authoring). Coverage is comprehensive for the domain with no filler.

5 / 5

Completeness

Explicitly answers what ("Create, modify, debug, and deploy... write their input and output schemas") and when ("Use when building an Actor from scratch, changing or troubleshooting Actor code, generating or updating .actor schema files, or pushing an Actor to the Apify platform") with multiple concrete trigger phrases, plus boundary guidance redirecting to apify-actorization.

5 / 5

Trigger Term Quality

Natural phrases are present — "building an Actor from scratch", "changing or troubleshooting Actor code", "pushing an Actor to the Apify platform", ".actor schema files" — but a few common user phrasings (e.g. "crawler", "scraper", "Apify CLI", "apify run/push") are absent. Good keyword coverage with minor synonyms missing, matching the 4 anchor better than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Apify Actors) with distinct trigger terms, and the closing line "To wrap an existing non-Actor project, use apify-actorization instead" explicitly disambiguates from the closest sibling skill, minimizing conflict 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

apify/agent-skills

Path

skills/apify-actor-development/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.