portable-skills-sync

Synchronize portable skill definitions with generated Cursor skill files.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/rbtkhn/grace-mar --skill portable-skills-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: portable-skills-sync
Source: https://github.com/rbtkhn/grace-mar/tree/main/.cursor/skills/portable-skills-sync
Command: npx skills add https://github.com/rbtkhn/grace-mar --skill portable-skills-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents drift between portable skill definitions and generated host-specific skill files by providing a consistent synchronization workflow.

Core Features & Use Cases

  • Manifest-Driven Syncing: Maintains portable skill cores, host appendices, and generated Cursor skill outputs through a registry-based process.
  • Verification Workflow: Checks portable skill constraints before writing generated files, helping catch invalid descriptions or forbidden content.
  • Use Case: Use this Skill when updating a portable skill collection and needing to verify and regenerate editor-facing skill files without manual edits.

Quick Start

Ask the portable-skills-sync skill to verify and synchronize the portable skills in the repository.

Frequently Asked Questions about portable-skills-sync

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

FAQPage Schema
How do I prevent configuration drift between portable skill definitions and generated Cursor skill files?▼

To prevent configuration drift, you can synchronize portable skill definitions with generated host skill files using a manifest-driven workflow. This process validates portable skill constraints and regenerates editor-facing Cursor skill outputs automatically.

What is manifest-driven skill syncing for portable skill collections?▼

Manifest-driven skill syncing maintains portable skill cores and host appendices through a registry-based process. It ensures source-to-target skill generation stays consistent by applying assembly rules and validation checks before writing generated files.

How do I verify portable skill constraints before regenerating editor-facing skill files?▼

You verify portable skill constraints by running a verification workflow that checks for invalid descriptions or forbidden content. This validation step executes before writing generated files, ensuring only compliant skill definitions are synchronized.

Can I use this skill sync workflow to update a portable skill collection without manual edits?▼

Yes, you can update a portable skill collection without manual edits by asking the synchronization workflow to verify and regenerate Cursor skill outputs. The manifest-driven process handles validation and file generation automatically across hosts.

What's the best way to regenerate Cursor skill outputs after editing portable skills?▼

The best way to regenerate Cursor skill outputs is through a synchronized source-to-target generation process. This applies manifest-driven assembly rules and validation checks to ensure generated files match the updated portable skill definitions.

Why do my generated host skill files keep drifting from my portable skill definitions?▼

Generated host skill files drift from portable skill definitions when updates bypass a synchronized workflow. Without manifest-driven assembly rules and verification checks, manual edits cause inconsistencies between source definitions and generated outputs.