bingo-compositions

Author static JSX composition sidecar files that expose React component examples as canvas templates.

Updated Sep 16, 2026
One-click install
npx skills add https://github.com/Carlosfengv/bingo --skill bingo-compositions-carlosfengv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bingo-compositions
Source: https://github.com/Carlosfengv/bingo/tree/main/packages/compiler/skills/bingo-compositions
Command: npx skills add https://github.com/Carlosfengv/bingo --skill bingo-compositions-carlosfengv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Components in a React project are not automatically insertable into the Bingo design canvas. Without a correctly authored *.compositions.tsx sidecar, a component shows no drag-and-drop templates in the Assets panel, and common authoring mistakes (function exports, lowercase names, missing imports) fail silently with no preview and no error. ## Core Features & Use Cases - Composition authoring rules: Defines the exact export contract the parser accepts — bare JSX elements (export const BadgeDefault = (<jsx/>)), uppercase names, explicit imports, and static data only. - Silent-failure debugging: Provides an ordered checklist for diagnosing missing previews, from function-shaped exports to wrong sidecar filenames and syntax errors that wipe out every export at once. - Naming and coverage guidance: Explains how camelCase export names become panel labels and how to cover a component's real variants, states, and compound structures. - Use Case: A user asks to "add compositions for the Badge component". The Skill directs reading the component source, writing badge.compositions.tsx into the project with project_write, and verifying each export appears in the Assets panel. ## Quick Start Ask the assistant to add compositions for a component, for example: "Add compositions for the Button component so it appears as insertable templates in the Assets panel."

Frequently Asked Questions about bingo-compositions

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

FAQPage Schema
How do I add canvas templates for a React component in Bingo?

Create a `*.compositions.tsx` sidecar next to the component file (e.g., `badge.compositions.tsx` beside `badge.tsx`) and export bare JSX elements like `export const BadgeDefault = (<Badge>Badge</Badge>)`. Each export becomes a draggable template in the Assets panel.

Why is my composition export not showing in the Assets panel?

The most common cause is exporting a function (`() => <jsx/>`) instead of a bare JSX element, which is silently ignored. Also check the filename uses `.compositions.` (plural), the export name starts uppercase, and the file has no syntax errors.

Can compositions use hooks, state, or event handlers?

No. Composition files are parsed statically and never executed, so hooks, handlers, conditionals, and `.map()` calls have no meaning. Only static JSX and plain data constants (strings, numbers, arrays, objects) are allowed.

Why did all exports in my compositions file disappear at once?

A single syntax error anywhere in the file causes every export in it to vanish simultaneously. If a whole component's templates disappear together, look for a typo rather than a missing export.

Do composition files need imports for the components they reference?

Yes. The parser resolves components and icons solely from the file's own import statements; there is no ambient scope. Every capitalized symbol referenced in the JSX must be explicitly imported from its real source.