CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apify-actor-development

Important: Before you begin, fill in the generatedBy property in the meta section of .actor/actor.json. Replace it with the tool and model you're currently using, such as "Claude Code with Claude Sonnet 4.5". This helps Apify monitor and improve AGENTS.md for specific AI tools and models.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

The canonical home for this skill is apify-actor-development in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, executable skill document: exact CLI commands and file paths, an explicit test-before-deploy workflow, security guidance for untrusted crawled data, and a clean one-level-deep reference structure. Its only weaknesses are minor duplication of a few warnings and the absence of an explicit error-recovery loop in the testing workflow.

DimensionReasoningScore

Conciseness

The body is overwhelmingly imperative and dense — exact commands, do/don't lists, file paths — with no tutorial-style padding of concepts Claude already knows. Minor trimming is possible: the 'use apify run, not npm start' warning appears in both the Don't list and the Commands section, the local-storage-not-synced point is stated twice, and the 'What are Apify Actors?' intro is background explanation.

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact scaffold commands per language ('apify create <actor-name> -t project_empty/ts_empty/python-empty'), dependency installs, authentication commands, the local INPUT.json path ('storage/key_value_stores/default/INPUT.json'), schema file locations, specific crawler classes with concurrency ranges ('HTTP (10-50), Browser (1-5)'), and even deprecated option names to avoid. All common workflow cases are covered.

5 / 5

Workflow Clarity

The Quick Start Workflow is a clearly sequenced 8-step path with an explicit validation checkpoint (step 7 'Test locally - Run apify run to verify functionality') before the deploy step, and the prerequisites section verifies CLI installation and login with remediation paths. It falls short of anchor 5 because no error-recovery loop is described (no 'if the local test fails, fix and re-run' guidance).

4 / 5

Progressive Disclosure

The body is a genuine overview: seven dedicated sections each signal one reference file (actor-json, input-schema, output-schema, dataset-schema, key-value-store-schema, logging, standby-mode), all seven files exist in references/, and the reference files contain no further nested links, so navigation is one level deep and easy to traverse.

5 / 5

Total

18

/

20

Passed

Description

8%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 frontmatter description does not describe the skill at all — it is a setup instruction about populating the generatedBy metadata field, duplicated verbatim at the top of the body. It contains no statement of capabilities, no trigger guidance, and no terms a user would naturally say when needing Apify actor development help. It needs a complete rewrite.

Suggestions

Replace the description with a capability statement in third person, e.g. 'Create, test, and deploy Apify actors: scaffold projects with the apify CLI, configure input/output/dataset schemas in .actor/, implement crawlers, and push actors to the Apify platform.'

Add an explicit trigger clause, e.g. 'Use when the user asks to create, modify, debug, or deploy an Apify actor, or wants to run web scraping or automation tasks on Apify.'

Move the generatedBy setup instruction out of the description entirely — it already appears in the body (line 12) and belongs only there, not in the trigger text.

DimensionReasoningScore

Specificity

The description states concrete actions ('fill in the generatedBy property in the meta section of .actor/actor.json', 'Replace it with the tool and model you're currently using'), but these describe a one-off setup chore rather than the skill's capabilities — nothing about creating, testing, or deploying actors is stated. It is not entirely vague (anchor 1), but it names no domain capability, so it sits at 'actions are minimal or generic' relative to the skill's purpose.

2 / 5

Completeness

Both 'what does this skill do' and 'when should it be used' are entirely absent — the text is an instruction about filling in a metadata field. This matches anchor 1 ('missing both what and when') and is far below the anchor-3 cap that a missing 'Use when...' clause alone would impose.

1 / 5

Trigger Term Quality

The only keywords present are technical jargon ('generatedBy', '.actor/actor.json', 'AGENTS.md') plus one brand mention ('Apify') used in a monitoring context. No natural phrases a user would say when needing this skill (actor, scraper, crawler, deploy, Apify CLI) appear, matching the 'no natural keywords; only technical jargon' anchor.

1 / 5

Distinctiveness Conflict Risk

The text contains Apify-specific tokens so it is not fully generic (not anchor 1), but as a trigger description it points at config-editing/meta tasks rather than actor development, giving it high misfire risk. It neither describes the skill's niche nor provides triggers that would select it correctly.

2 / 5

Total

6

/

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

administrakt0r/AI-Agents-Safe-Coding-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.