contribute-catalog

Scaffold HyperFrames catalog items and generate registry entries.

118|12|Updated May 5, 2026
One-click install
npx skills add https://github.com/alecs5am/ralphy --skill contribute-catalog-alecs5am
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contribute-catalog
Source: https://github.com/alecs5am/ralphy/tree/main/.agents/skills/contribute-catalog
Command: npx skills add https://github.com/alecs5am/ralphy --skill contribute-catalog-alecs5am

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Contributors often struggle to create upstream-ready HyperFrames catalog entries. This skill provides a clear, repeatable workflow to author, structure, and submit blocks or components to the HyperFrames registry.

Core Features & Use Cases

  • Scaffold catalog items under registry/blocks or registry/components with the required HTML, registry-item.json, and supporting files.
  • Provide templates and checks to generate and validate registry metadata and catalog pages for discovery and review.
  • Enable a PR-driven collaboration process with clear expectations (lint, preview, and governance) before merging.

Quick Start

Create a feature branch for a new catalog item, scaffold the registry structure, and open a PR with a live preview link.

Frequently Asked Questions about contribute-catalog

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

FAQPage Schema
How do I contribute a new component to a catalog registry?

Contributing a new component to a catalog registry requires scaffolding the item structure, defining metadata in a registry-item.json file, and preparing an updated registry.json entry for a reviewable preview.

What files do I need to scaffold for a HyperFrames catalog entry?

Scaffolding a HyperFrames catalog entry requires generating the required HTML file, a registry-item.json for metadata, and supporting files under registry/blocks or registry/components directories.

How do I ensure my catalog item is ready for a PR review?

To ensure your catalog item is ready for a PR review, you must verify all IDs are unique, declare all dependencies, generate a catalog page, and publish a reviewable preview link.

What is the workflow for submitting blocks to a registry?

The workflow for submitting blocks to a registry involves creating a feature branch, scaffolding the required structure files and metadata, validating uniqueness, and opening a PR with a live preview.

Do I need to manually update the registry.json file when adding a new block?

You do not need to manually update the registry.json file entirely, as the workflow generates the catalog page and ensures the updated registry.json automatically includes the new entry.