CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apify-generate-output-schema

Deprecated. Output schema generation moved to the apify-actor-development skill; prefer that skill whenever it is available.

Quality

78%

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-generate-output-schema/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%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 an exemplary deprecation notice: lean, fully actionable, and unambiguous about both the redirect path and the fallback install instructions. It covers both availability branches with exact commands and an explicit guardrail against hallucinating schemas. No changes are needed.

DimensionReasoningScore

Conciseness

Every sentence does work: it states what moved, where it moved, the exact schema files involved, and the exact commands to install the replacement. There is no explanation of concepts Claude already knows and no padding, matching the "lean and efficient" anchor 5 rather than 4 (no trimming opportunities remain).

5 / 5

Actionability

The guidance is copy-paste ready: `references/output-schemas.md` to load, `/plugin install apify-actor-development@apify-agent-skills`, `npx skills add https://github.com/apify/agent-skills --skill apify-actor-development`, and the cloned-repo path. It also includes an explicit behavioral guardrail ("Do not write the schemas from memory") with a concrete stop condition, fully matching anchor 5.

5 / 5

Workflow Clarity

The two branches (replacement available -> load and follow it; unavailable -> inform the user, help install, then stop) are unambiguous and cover both cases, including how to pick the install method. As a single-purpose skill whose one action is a redirect, the sequence is fully explicit with no gaps, satisfying the simple-skill exception; there are no destructive or batch operations requiring validation loops.

5 / 5

Progressive Disclosure

The body is ~15 lines with no need for external references in this bundle (no references/, scripts/, or assets/ directories exist), and it is well organized as heading, summary paragraph, and structured decision list. Its single reference (`references/output-schemas.md`) is one level deep into the successor skill and clearly signaled, matching the guideline that short skills with no external-reference needs can score 5 with well-organized sections.

5 / 5

Total

20

/

20

Passed

Description

48%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 honest and appropriately brief for a deprecated skill, clearly stating where the functionality moved. Its main weaknesses are the missing "when to use" trigger guidance and sparse natural trigger keywords beyond "output schema". As a deprecation pointer it serves its purpose, but scored strictly against the rubric it is a mid-range description.

Suggestions

Add an explicit trigger clause, e.g. "Use when asked to generate or update Actor output schemas (dataset_schema.json, output_schema.json, key_value_store_schema.json), then prefer apify-actor-development instead."

Include the concrete schema file names and common synonyms ("output schema", "dataset schema", "key-value store schema") as trigger terms so the deprecated skill still routes users correctly.

State the "what" as an action ("Redirects output schema generation to the apify-actor-development skill") rather than only describing the deprecation status.

DimensionReasoningScore

Specificity

The description names the domain ("Output schema generation") but states no concrete actions this skill performs; it only says functionality "moved to the apify-actor-development skill". It sits at anchor 2 (domain named, actions minimal) rather than 3 because there is no second concrete capability or action listed.

2 / 5

Completeness

The "what" is clear (output schema generation has moved; prefer apify-actor-development), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It does not reach 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"Output schema generation" and "apify-actor-development" are natural terms a user working on Actor output schemas would say, but common variations and file-based synonyms (e.g. "dataset_schema.json", "Actor output", "JSON schema") are missing. This matches anchor 3 (some relevant keywords, missing variations), not 2 since the keywords are specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

The domain (Apify Actor output schemas) is a clear niche with distinct terminology, but this skill triggers on exactly the same requests as its successor skill (apify-actor-development), creating minor overlap risk with a closely related skill. That matches anchor 4 rather than 5; it is above 3 because the niche terminology is quite specific and unlikely to collide with unrelated skills.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

apify/agent-skills

Path

skills/apify-generate-output-schema/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.