msx:link

Shares, retrieves, and synchronizes changes and interface contracts across MixSpec repositories using Git and AI analysis.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/xxyj/xx-ai-cli --skill msx-link
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: msx:link
Source: https://github.com/xxyj/xx-ai-cli/tree/main/.cursor/skills/msx-17-link
Command: npx skills add https://github.com/xxyj/xx-ai-cli --skill msx-link

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, python, pypdf, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies multi-repo collaboration and linking within the MixSpec ecosystem by providing a seamless way to share and integrate changes across repositories.

Core Features & Use Cases

  • Link Sharing: Share changes and their interface contracts with other repositories for collaboration.
  • Link Joining: Pull remote changes and perform semantic analysis to update local files and dependencies.
  • Link Update: Re-fetch all linked external contracts, refresh local snapshots, and update the 'External Dependencies' section of the local spec.md.
  • Use Case: For teams working on different components of a product across multiple repositories, this Skill ensures consistency and alignment by facilitating seamless integration of changes.

Quick Start

Use the /msx:link share command to generate a MSX_LINK for your change.

Frequently Asked Questions about msx:link

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

FAQPage Schema
How do I share interface contract changes across multiple Git repositories?

To share interface contract changes across multiple Git repositories, use the link sharing feature to generate an MSX_LINK for your change. This allows other repositories to retrieve and integrate the shared changes seamlessly.

What is semantic analysis used for in multi-repo collaboration?

Semantic analysis in multi-repo collaboration is used during link joining to understand and integrate remote changes. It processes the retrieved changes to automatically update local files and dependencies.

Do I need Git and Python to manage MixSpec repository linking?

Yes, you need Git and Python to manage MixSpec repository linking, along with the pypdf dependency. The Skill requires Git operations for branching logic and Python for executing the semantic analysis scripts.

How do I refresh local snapshots and external dependencies in spec.md?

To refresh local snapshots and external dependencies in spec.md, perform a link update operation. This re-fetches all linked external contracts and updates the External Dependencies section of your local specification.

What are the limitations when synchronizing changes across repositories?

Limitations when synchronizing changes across repositories include strict constraints imposed by repository access permissions and Git branching logic. Operations will fail if the user lacks proper Git access or branch privileges.

When do I need to update interface contracts in a multi-repo environment?

You need to update interface contracts in a multi-repo environment when teams working on different product components require consistency. This process ensures alignment by facilitating the seamless integration of changes across separate repositories.