sync-skills

Sync local agent skills by running the sync_skills.py script, which pulls enabled skills from the Supabase rule_ledger.skills table and writes them directly to the local skills/ directories across your repositories. This ensures all development environments have available and up-to-date capabilities.

Keeping local skills directories updated requires using a centralized rule ledger as the single source of truth. This skill validates pulled skills across multiple repositories and automatically updates local copies when changes occur, guaranteeing consistent skill availability for distributed projects.

Validating skill availability across multiple repositories like scceo-1, kai-agent, freely, and rocket is supported. The sync process checks these local directories against the Supabase rule ledger and automatically pulls missing or out-of-date skills to ensure consistency.

This skill synchronization relies specifically on the rule_ledger.skills table in Supabase as the single source of truth. It queries this database table to determine which skills are enabled and then writes the validated copies to local agent repositories.

Local agent skills become out of date when the global Supabase rule ledger is updated but local repositories are not synced. Running the sync_skills.py script resolves this by checking the rule ledger and overwriting stale local copies with the latest versions.

You need to sync skills from a rule ledger when onboarding new agents, refreshing stale skills, or ensuring consistent skill availability across distributed projects. It handles missing or out-of-date skills by pulling directly from the global registry.