bridge-artifact

Convert superpowers documentation artifacts to Ralph-Hero YAML frontmatter.

2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/cdubiel08/ralph-hero --skill bridge-artifact
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bridge-artifact
Source: https://github.com/cdubiel08/ralph-hero/tree/main/plugin/ralph-hero/skills/bridge-artifact
Command: npx skills add https://github.com/cdubiel08/ralph-hero --skill bridge-artifact

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the migration of existing documentation artifacts from the 'superpowers' format to the standardized Ralph-Hero format, ensuring consistency and discoverability.

Core Features & Use Cases

  • Format Conversion: Transforms 'superpowers' specs and plans into Ralph-Hero's YAML frontmatter structure.
  • Metadata Enrichment: Automatically extracts and infers crucial metadata like dates, titles, and tags.
  • GitHub Integration: Optionally links artifacts to GitHub issues, enhancing traceability.
  • Use Case: You have a collection of design specifications in the old 'superpowers' format. Use this Skill to convert them into Ralph-Hero's research format, complete with frontmatter and links to relevant GitHub issues, making them readily usable by the Ralph-Hero system.

Quick Start

Use the bridge-artifact skill to convert the superpowers artifact located at docs/superpowers/plans/2026-03-12-feature.md and link it to issue number 42.

Frequently Asked Questions about bridge-artifact

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

FAQPage Schema
How do I convert documentation artifacts from the superpowers format to Ralph-Hero YAML frontmatter?

To convert documentation artifacts, this skill processes superpowers specifications and plans, automatically extracting metadata like dates, titles, descriptions, and tags to generate Ralph-Hero YAML frontmatter. Converted files are saved directly to the 'thoughts/shared/' directory for immediate system integration.

Can I automatically link migrated Ralph-Hero artifacts to GitHub issues?

Yes, you can link migrated Ralph-Hero artifacts to GitHub issues. During the artifact conversion process, you can optionally specify a GitHub issue number, and the skill will link the artifact and optionally create comments on the associated GitHub issues to enhance traceability.

What metadata is extracted when converting superpowers specs to the Ralph-Hero research format?

When converting superpowers specs to the Ralph-Hero research format, the skill automatically extracts and infers metadata including dates, descriptions, titles, and tags. This metadata enrichment ensures your converted documentation artifacts remain consistent and discoverable within the Ralph-Hero system.

Does the bridge-artifact skill require any dependencies to process superpowers plans?

No, the bridge-artifact skill does not require any external dependencies to process superpowers plans. It operates independently using internal scripts to transform your existing design specifications into the standardized Ralph-Hero YAML frontmatter structure.

Where are converted Ralph-Hero documentation artifacts saved after migration?

Converted Ralph-Hero documentation artifacts are saved to the 'thoughts/shared/' directory. This ensures the migrated specifications and plans are readily usable and accessible by the Ralph-Hero system immediately after the conversion process completes.