canvas-component-metadata

Validate and standardize Canvas component.yml metadata for components.

16|6|Updated Feb 19, 2025
One-click install
npx skills add https://github.com/acquia/nebula --skill canvas-component-metadata-acquia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: canvas-component-metadata
Source: https://github.com/acquia/nebula/tree/main/.agents/skills/canvas-component-metadata
Command: npx skills add https://github.com/acquia/nebula --skill canvas-component-metadata-acquia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams define and validate the canonical Canvas component.yml metadata (name, machineName, status, props, slots, enums) to ensure consistency across components and prevent schema errors.

Core Features & Use Cases

  • Enforces a consistent component.yml structure with required top-level keys and proper typing.
  • Guides prop, slot, and enum definitions to support predictable Canvas editors and runtime behavior.
  • Use Case: Creating a new Canvas component or updating an existing one to align with project-wide metadata standards.

Quick Start

Create or update component.yml to include the required fields and adhere to the schema described in this Skill.

Frequently Asked Questions about canvas-component-metadata

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

FAQPage Schema
How do I validate Canvas component.yml metadata for props and slots?

To validate Canvas component.yml metadata, define the required top-level keys: name, machineName, status, required, props, and slots. This ensures consistent prop definitions, slot mappings, and enum usage across teams to prevent schema errors.

What are the required top-level keys in a Canvas component.yml file?

The required top-level keys in a Canvas component.yml file are name, machineName, status, required, props, and slots. Each key must be defined with correct types and examples per the YAML spec to ensure predictable Canvas editors and runtime behavior.

How do I standardize enum usage when creating a new Canvas component?

To standardize enum usage in a new Canvas component, follow the schema described in the component.yml validation rules. This guides prop, slot, and enum definitions to support predictable Canvas editors and maintain project-wide metadata standards.

Does Canvas component validation require specific YAML types and examples for slots?

Yes, Canvas component validation requires the top-level keys in component.yml to be defined with correct types and examples per the YAML spec. This applies to both creating new components and updating existing ones across teams.

Why does my Canvas component metadata fail schema validation across teams?

Canvas component metadata fails schema validation when required top-level keys like name, machineName, status, props, and slots are missing or incorrectly typed. Enforcing a consistent component.yml structure prevents these schema errors and aligns with project-wide standards.