skills-sync

Refreshes bundled Claude Code and Codex skills from canonical tx sources into a target project.

6|3|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/jamesaphoenix/tx --skill skills-sync-jamesaphoenix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-sync
Source: https://github.com/jamesaphoenix/tx/tree/main/.claude/skills/skills-sync
Command: npx skills add https://github.com/jamesaphoenix/tx --skill skills-sync-jamesaphoenix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refreshes the bundled tx Claude Code and Codex skills in a target project from the canonical tx source, eliminating manual copy/paste.

Core Features & Use Cases

  • Syncs the Claude Code and Codex skill templates from the canonical tx repository into a local or target project.
  • Preserves existing custom local skills in the target while updating the bundled set.
  • Supports targeting Claude, Codex, or both, and allows specifying a project directory for non-root workflows.

Quick Start

Run the skills-sync operation in the canonical tx checkout to refresh the host skill bundle in your target project.

Frequently Asked Questions about skills-sync

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

FAQPage Schema
What happens to SKILL.md frontmatter when syncing skills from tx?

Syncing skills from tx relies on the SKILL.md frontmatter for discovery, ensuring the refreshed Claude Code and Codex skill templates maintain proper structure for optional scripts, references, and assets.

How do I sync Claude Code and Codex skills into a local project?

To sync Claude Code and Codex skills, run the skills-sync operation from the canonical tx checkout to refresh bundled skill templates directly into your target project directory.

Can I update Codex skill templates without overwriting my custom local skills?

Yes, syncing Codex skill templates from the canonical tx source preserves existing custom local skills in your target project while only refreshing the bundled set.

Does skills-sync work with non-root project directories?

Yes, skills-sync supports specifying a project directory, allowing you to refresh Claude Code and Codex skill templates into non-root workflows without operating exclusively in the root folder.

What is the best way to refresh bundled Claude Code skills from tx?

The best way to refresh bundled Claude Code skills is running skills-sync in the canonical tx checkout, which eliminates manual copy and paste by pulling directly from tx sources.

Why does syncing project skills require the canonical tx checkout?

Syncing project skills requires the canonical tx checkout because it serves as the source repository from which the latest Claude Code and Codex skill templates are pulled into your target project.