apify-generate-output-schema

Generate Apify Actor output schemas from source code analysis.

1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/williamsforeal/Cyclone-SS --skill apify-generate-output-schema-williamsforeal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apify-generate-output-schema
Source: https://github.com/williamsforeal/Cyclone-SS/tree/main/global-skills/apify-generate-output-schema
Command: npx skills add https://github.com/williamsforeal/Cyclone-SS --skill apify-generate-output-schema-williamsforeal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apify Actors often ship without precise output schemas, which makes results hard to understand, filter, and display correctly in Apify Console.

Core Features & Use Cases

  • Schema-first accuracy: Reads the Actor’s source code to list exactly what the Actor pushes to the dataset and key-value store, avoiding guesswork.
  • Console-ready schema files: Generates dataset_schema.json (and key_value_store_schema.json when applicable) plus updates actor.json so results render properly.
  • Safer, predictable schemas: Marks every field as nullable and supports nested objects/arrays with the required draft-07 conventions for Apify.
  • Consistency with your repo: Searches for existing schema conventions in other Actors and mirrors their naming, formatting, and view structure.

Quick Start

In an Actor project directory, ask the apify-generate-output-schema skill to analyze the Actor’s source and generate dataset_schema.json, output_schema.json, and key_value_store_schema.json (when key-value storage is used) based on the data actually produced by the code.

Frequently Asked Questions about apify-generate-output-schema

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an Apify dataset schema from my Actor's source code?

To generate an Apify dataset schema, the Skill analyzes your Actor's TypeScript or Python source code to extract field definitions and push calls. It outputs a draft-07 JSON schema file that accurately maps your dataset fields for Apify Console rendering.

Why does Apify Console display my Actor results incorrectly or with missing fields?

Apify Console displays results incorrectly when your Actor lacks a precise output schema. By analyzing your source code and generating a dataset_schema.json file with exact fields and nullable properties, the Console can properly filter and render your run data.

How do I define a key-value store schema for my Apify Actor?

You define a key-value store schema by analyzing your Actor's code for set calls to the key-value store. The Skill generates a key_value_store_schema.json file using draft-07 JSON schema conventions, ensuring the stored contents render accurately in Apify Console.

Can I automatically update actor.json with a new output schema during development?

Yes, you can update actor.json automatically during development. The Skill generates the necessary schema files and updates actor.json to reference them, ensuring Apify Console applies the correct view structure and formatting to your dataset and run results.

Does the Apify output schema generator support nested objects and arrays?

Yes, the schema generator supports nested objects and arrays. It produces draft-07 JSON schema with additionalProperties set at all object levels and marks every field as nullable to maintain predictable and safe schema conventions for Apify.

What is the best way to ensure schema consistency across multiple Apify Actors?

The best way to ensure schema consistency is to search your repository for existing schema conventions in other Actors. The Skill mirrors their naming, formatting, and view structure to generate consistent dataset_schema.json and key_value_store_schema.json files.