Add /generate-output-schema command

[patrikbraborec]

Summary

• Adds a new /generate-output-schema slash command that analyzes Actor source code and generates dataset_schema.json, output_schema.json, key_value_store_schema.json (if applicable), and updates actor.json
• The command follows a 7-phase workflow: discover Actor structure, generate dataset schema, generate key-value store schema, generate output schema, update actor.json, review/validate, and summarize
• Includes hard rules for schema correctness (nullable on every field, additionalProperties, anonymized examples, type+nullable co-requirement)

How to test before merge

Option 1: Load the plugin locally from the branch

# Clone and checkout the branch
git clone -b output-schema-skills https://github.com/apify/agent-skills.git /tmp/agent-skills-test

# Start Claude Code with the plugin loaded from local directory
claude --plugin-dir /tmp/agent-skills-test

Option 2: If you already have the repo cloned

cd /path/to/agent-skills
git fetch origin output-schema-skills
git checkout output-schema-skills

Run the command in your Actor

Navigate to an Actor project and invoke:

claude --plugin-dir <path>/agent-skills

/apify-agent-skills:generate-output-schema

What to verify

• The command discovers all pushData / push_data calls and output type definitions
• The command discovers all setValue / set_value calls for key-value store usage
• Generates dataset_schema.json with correct field types, nullable: true, additionalProperties: true, and anonymized examples
• Generates key_value_store_schema.json with collections matching discovered key patterns (if Actor uses KV store)
• Generates output_schema.json with "type": "string" on every property
• Updates actor.json with schema file references (including storages.keyValueStore when applicable)
• Presents schemas for review before writing files

🤖 Generated with Claude Code