Skip to content

create-api contract mismatch: renderer emits examples as tables, SKILL parses only description + fenced code block #9

Description

@svetlinata

Summary

The component-md renderer instruction (references/component-md/agent-component-md-instruction.md) emits API configuration examples as Property | Value | Notes markdown tables. But create-api's SKILL.md parses examples only in the "description + fenced code block" shape. Result: when a canvas run consumes a generated .md, the examples section silently yields no parsed examples — the Config Examples panel and its live previews are dropped without an error.

Where

  • Emitter: references/component-md/agent-component-md-instruction.md (Config examples section shape)
  • Consumer: create-api SKILL.md example-parsing step

Reproduction

  1. Generate a spec with create-component-md — the .md's "Configuration examples" arrive as Property | Value | Notes tables.
  2. Run create-api against that .md.
  3. The example parser finds no fenced code blocks → examples/live previews are silently omitted from the rendered API Overview frame.

Impact

Fired on every component in our batches (30+ components across atoms/molecules/organisms). Workaround: manually map table rows onto the template's example slots at render time.

Suggested fix

Either emit examples as description + fenced code from the renderer instruction, or teach create-api's parser to accept the table shape. Aligning the two contracts in either direction resolves it.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions