CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apify-actor-development

Create, modify and validate Apify Actors with scoped inputs, storage schemas, runtime logic and deployment review.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/apify-actor-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers highly actionable, well-sequenced guidance with excellent progressive disclosure — every reference file exists and is clearly linked one level deep. The main weaknesses are moderate verbosity (background explanation of what Actors are, and triple-repeated local-storage warnings) and the absence of any example actor runtime code in the main workflow.

Suggestions

Cut or shrink the "What are Apify Actors?" section to one line and consolidate the local-storage-is-not-synced warning into the Local Testing section, removing the duplicates in Best Practices and Execution/data scope.

Add a minimal executable actor snippet (input validation → dataset push) under "Implement logic" so all eight workflow steps are concrete.

Add an explicit feedback loop to the Quick Start (e.g. "If apify run fails, fix and re-run before proceeding to deploy") and restructure the dense "Execution and data scope" prose into the Security section as short bullets.

DimensionReasoningScore

Conciseness

The body is mostly efficient — command blocks and do/don't lists are tight — but includes unnecessary or padded material: the "What are Apify Actors?" section explains platform basics Claude can infer, the local-storage-not-synced warning is repeated three times (Best Practices ✗ list, Local Testing, and the Execution and data scope section), and the dense "Execution and data scope" prose is hard to parse. This fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4, where only minor trimming would be needed.

3 / 5

Actionability

Concrete, copy-paste-ready commands appear throughout: "apify create <actor-name> -t project_empty", "npm install -g apify-cli", "apify info # Should return your username", "storage/key_value_stores/default/INPUT.json", and specific concurrency ranges (HTTP 10-50, Browser 1-5). It falls short of 5 because the core deliverable — "Implement logic - Write the actor code in src/main.py/js/ts" — has no example actor snippet, leaving a minor gap; it is above 3 because the guidance is executable, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

The 8-step Quick Start Workflow is clearly sequenced with concrete commands and includes a verification checkpoint ("Test locally - Run apify run to verify functionality") before the deploy step, plus prerequisite checks (verify CLI installed, verify login). It matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than 5 because there is no explicit feedback loop (test fails → fix → re-test) for the deploy/publish path, and rather than 3 because validation steps are explicit rather than implicit.

4 / 5

Progressive Disclosure

The body is a well-organized overview that consistently delegates detail to seven real, one-level-deep reference files, each clearly signaled ("See [references/actor-json.md](references/actor-json.md) for complete actor.json structure", likewise logging, standby-mode, input/output/dataset/key-value-store schemas), and all seven files in references/ are actually referenced. This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation; no nesting or buried references were found.

5 / 5

Total

16

/

20

Passed

Description

70%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 specific, action-oriented, and highly distinctive within the Apify Actor niche, using third-person imperative voice. Its main weakness is the absence of any explicit 'when to use' trigger clause, which caps completeness at 3, plus a few missing natural trigger terms such as web scraping, crawler, or Apify CLI.

Suggestions

Append an explicit trigger clause, e.g. "Use when creating, debugging, or deploying Apify Actors, or when the user mentions Apify, actors, or building scrapers/crawlers on Apify."

Add natural trigger terms users actually say — "web scraping", "crawler", "scraper", "Apify CLI" — to widen trigger coverage.

Replace the slightly vague "deployment review" with a concrete action like "deploy with apify push" to sharpen the 'what'.

DimensionReasoningScore

Specificity

"Create, modify and validate Apify Actors with scoped inputs, storage schemas, runtime logic and deployment review" names several concrete actions (create, modify, validate) tied to specific domain artifacts (scoped inputs, storage schemas, runtime logic, deployment review), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because coverage has gaps (no mention of testing/debugging, templates, or local runs) and 'deployment review' is slightly vague; it is clearly above 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clear (create, modify, and validate Apify Actors with inputs, schemas, runtime logic, deployment), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It cannot be 4 without any 'when' statement, and it is not 2 because the 'what' is concrete and multi-part rather than vague.

3 / 5

Trigger Term Quality

"Apify Actors", "inputs", "storage schemas", and "deployment" are natural terms a user building on Apify would say, giving good keyword coverage. It misses a few natural terms — notably "web scraping", "crawler"/"scraper", and "Apify CLI" — which are common variations for this domain, so it fits anchor 4 rather than 5; it is above anchor 3 because the core trigger vocabulary is present and specific rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"Apify Actors" is a clear niche with distinct, platform-specific triggers; virtually no other skill would claim this scope, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor. It cannot be lower because nothing in the description is generic or overlapping with adjacent document/code skills.

5 / 5

Total

16

/

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

sickn33/agentic-awesome-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.