apify-generate-output-schema

Generate output schemas (dataset_schema.json, output_schema.json, key_value_store_schema.json) for an Apify Actor by analyzing it…

apify 2.3k ↓ 6.6k updated 1mo ago

Claude Code

View source ↗

What it does

Analyze code first: Read the Actor's source to understand what data it actually pushes to the dataset — never guess
Every field is nullable: APIs and websites are unpredictable — always set "nullable": true
Anonymize examples: Never use real user IDs, usernames, or personal data in examples
Verify against code: If TypeScript types exist, cross-check the schema against both the type definition AND the code that produces the values
Don't reinvent the wheel: Reuse existing type definitions, interfaces, and utilities from the codebase instead of creating duplicate definitions
JavaScript/TypeScript: Search for Actor.pushData(, dataset.pushData(, Dataset.pushData(
Python: Search for Actor.pushdata(, dataset.pushdata(, Dataset.pushdata(

Requirements & configuration

2. Only adding "required": [] and "additionalProperties": true on nested object-type properties but forgetting them on the top-level fields object. Both levels need them.
Any fields that need user clarification (ambiguous types, unclear nullability)

Configuration: ARGUMENTSINPUT

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Generate output schemas (dataset_schema.json, output_schema.json, key_value_store_schema.json) for an Apify Actor by analyzing its source code. Use when creating or updating Actor output schemas.

Source

Repository: https://github.com/apify/agent-skills

apify-generate-output-schema FAQ

What does the apify-generate-output-schema skill do?

Generate output schemas (dataset_schema.json, output_schema.json, key_value_store_schema.json) for an Apify Actor by analyzing its source code. Use when creating or updating Actor output schemas. Analyze code first: Read the Actor's source to understand what data it actually pushes to the dataset — never guess Every field is nullable: APIs and websites are unpredictable — always set "nullable": true

What does apify-generate-output-schema require?

2. Only adding "required": [] and "additionalProperties": true on nested object-type properties but forgetting them on the top-level fields object. Both levels need them. Any fields that need user clarification (ambiguous types, unclear nullability) Configuration keys: ARGUMENTS, INPUT.

How do I install apify-generate-output-schema?

Run: npx -y skills add https://github.com/apify/agent-skills --skill apify-generate-output-schema --agent claude-code — the source lives at github.com/apify/agent-skills.

Maintain apify-generate-output-schema?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![apify-generate-output-schema on getagentictools](https://getagentictools.com/badge/skills/apify-agent-skills-apify-generate-output-schema.svg)](https://getagentictools.com/skills/apify-agent-skills-apify-generate-output-schema?ref=badge)

npx agentictools info skills/apify-agent-skills-apify-generate-output-schema

The second line is the CLI lookup for this page — handy in READMEs and docs.