supabase-transmuter

Archive legacy knowledge base entries and update Supabase records with versioned metadata.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Icebane84/Synarche_Workshop --skill supabase-transmuter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supabase-transmuter
Source: https://github.com/Icebane84/Synarche_Workshop/tree/main/.agent/skills/supabase-transmuter
Command: npx skills add https://github.com/Icebane84/Synarche_Workshop --skill supabase-transmuter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires supabase, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of keeping a knowledge base consistent by turning legacy entries into canonized records with versioned metadata.

Core Features & Use Cases

  • Batch scanning for legacy content: Retrieves rows from the Supabase knowledge base excluding a specific legacy version marker in JSON metadata.
  • Unified diffs for review: Generates a human-readable diff between legacy and canonized content to support change validation.
  • Safe archival + update (transmutation): Archives the original content into a history table and then updates the target row with new content, title, and structured metadata for traceability.

Quick Start

Run the commit_transmutation tool to archive an existing knowledge_base record and update it with canonized content plus new metadata.

Frequently Asked Questions about supabase-transmuter

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

FAQPage Schema
How do I migrate legacy knowledge base entries in Supabase to a versioned format?

To migrate legacy knowledge base entries in Supabase, this Skill archives original content into a history table and updates records with versioned state and provenance metadata. It scans for out-of-date entries, generates diffs for review, and commits the transformed content back to the canonical table.

What is canonization for Supabase knowledge base records?

Canonization for Supabase knowledge base records is the process of transforming legacy entries into standardized, versioned metadata. It involves archiving original content to a history table and updating the target row with new content, title, and structured metadata for traceability.

Do I need Supabase credentials to canonize knowledge entries?

Yes, canonizing knowledge entries requires Supabase credentials via the SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY environment variables. The process performs deterministic CLI operations against the knowledge_base and knowledge_history tables using these credentials.

How does diff generation work for Supabase knowledge base updates?

Diff generation for Supabase knowledge base updates produces a human-readable comparison between legacy and canonized content. This mechanism supports change validation by allowing you to review the exact modifications before committing the transformed content back to the database.

What is the best way to archive original content before updating Supabase records?

The best way to archive original content before updating Supabase records is using a transmutation workflow that safely moves the existing data into a history table. This approach preserves provenance metadata before applying updates to the canonical knowledge base table.

Can I batch scan Supabase rows for out-of-date metadata?

Yes, you can batch scan Supabase rows for out-of-date metadata by retrieving records that exclude a specific legacy version marker in their JSON metadata. This identifies entries needing canonization within batch refactoring workflows.