CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

45

Quality

48%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/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

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 content is a strong, well-structured Apify Actor development guide with executable commands, clear sequencing, and excellent progressive disclosure via verified reference files. Its main weakness is minor repetition of the apify-run/local-storage caveats that could be consolidated.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete commands and tight do/don't lists, but repeats itself: the "use apify run, not npm start" warning appears in Best Practices, Commands, and again implicitly, and the generatedBy note duplicates the frontmatter.

3 / 5

Actionability

It provides copy-paste-ready CLI commands with flags (apify create -t python-empty, apify run, apify push) and concrete file paths for schemas and local storage; minor gaps are acceptable given detail is delegated to references.

4 / 5

Workflow Clarity

The 8-step Quick Start Workflow is clearly sequenced with a "Test locally" checkpoint (step 7) before deploy (step 8); it lacks an explicit test-failure feedback loop, so it sits just below the validation-loop anchor.

4 / 5

Progressive Disclosure

The body is a well-signaled overview that links one level deep to seven real reference files (actor-json, input/output/dataset/key-value-store schemas, logging, standby-mode), all of which exist in ./references/, with content appropriately split out.

5 / 5

Total

16

/

20

Passed

Description

25%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 is a copy-pasted setup instruction (fill in generatedBy) rather than a description of the skill's purpose, capabilities, or triggers. It fails to tell Claude what the skill does or when to invoke it, scoring poorly across all dimensions.

Suggestions

Rewrite the description to state the skill's purpose in third person, e.g. "Develops, tests, and deploys Apify Actors (serverless scraping/automation programs) using the apify CLI."

Add an explicit "Use when..." trigger clause listing natural terms users would say: building an Apify actor, web scraping with Apify, deploying a crawler, apify create/push.

Move the generatedBy fill-in instruction into the body's setup section so the description is freed for its actual job of triggering and capability signaling.

DimensionReasoningScore

Specificity

The description names a concrete action ("fill in the generatedBy property in .actor/actor.json") but this is an admin chore, not a capability of the skill; the actual domain (Apify actor development) is never named, so actions are minimal and misdirected.

2 / 5

Completeness

It answers neither what the skill does nor when to use it; the only "what" present is a setup chore, and there is no "Use when..." clause, so the explicit-trigger cap of 3 is not even reached.

2 / 5

Trigger Term Quality

It references technical jargon ("generatedBy", ".actor/actor.json", "Claude Code with Claude Sonnet 4.5") but includes none of the natural trigger phrases a user would say to invoke Apify actor work (actor, apify, scrape, crawl, deploy).

2 / 5

Distinctiveness Conflict Risk

Because the description never mentions Apify actors or scraping, it does not establish a clear niche and would not reliably trigger for this skill; the generic administrative framing carries high overlap/miss risk.

2 / 5

Total

8

/

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.

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