Code Generation FAQs

Question 1

What does the Code Generation skill do?

Accepted Answer

This skill automates the creation of JSON schemas and OpenAPI specifications for blockchain dataset manifests and API definitions using predefined justfile tasks. It ensures that your documentation always matches your underlying Rust code structures.

Question 2

How does this skill improve the development workflow?

Accepted Answer

It eliminates the risk of manual errors by replacing manual file editing with automated scripts. By using the 'just gen' command, Claude can synchronize all project schemas and specifications in one sequence, keeping the codebase and docs in perfect sync.

Question 3

What specific formats and files does it generate?

Accepted Answer

It generates JSON schemas for common, derived, EVM RPC, and Firehose dataset manifests located in 'docs/manifest-schemas/' and OpenAPI specifications for the Admin API in 'docs/openapi-specs/'.

Question 4

Can I specify custom output directories for the generated files?

Accepted Answer

Yes, while the skill has default paths in the 'docs' folder, all generation commands support an optional DEST_DIR parameter to route the generated specifications to a custom location.

Question 5

When should I use this skill?

Accepted Answer

You should trigger this skill whenever you modify dataset manifest structures, update Admin API endpoint definitions, add new schema fields, or need to regenerate project documentation to prevent validation errors.

Code Generation

Code Generation

Key Features

Use Cases

Key Features

Use Cases