uc-apx skills sync

Downloads all uc-apx skills from the public United-Codes/uc-apx repository and installs them into your coding agent’s skills directory. Skills are SKILL.md playbooks that teach your agent to use uc-apx commands (create pages, validate apps, investigate components, etc.).

Usage

uc-apx skills sync [flags]

Flags

Flag	Type	Default	Description
--global			Install to home directory (~/.claude/skills/ or ~/.agents/skills/) instead of the current working directory
--agent	string	auto-detect	Target agent: claude-code or universal. Auto-detects claude-code if ~/.claude/ exists, otherwise falls back to universal
--dry-run			Print what would be installed without writing any files

Global Flags

Flag	Type	Default	Description
--json			Output in JSON format instead of TOON

Examples

Default: local install for auto-detected agent

uc-apx skills sync

Detects Claude Code (if ~/.claude/ exists) and writes skills to .claude/skills/ in the current directory.

Global install

uc-apx skills sync --global

Installs to ~/.claude/skills/ (or ~/.agents/skills/ for universal), making skills available in every project without re-running sync.

Dry run — preview without writing

uc-apx skills sync --dry-run

target: /path/to/project/.claude/skills
installed[8]{name,description,category}:
  navigate-app,"Orient yourself in an apexlang app",read
  investigate-component,"Inspect any component in detail",read
  ...
dryRun: true

Force universal agent

uc-apx skills sync --agent universal

Installs to .agents/skills/ regardless of which agent is detected. Compatible with Cursor, Windsurf, Continue, and any other agent following the universal skills spec.

JSON output

uc-apx skills sync --json

{
  "target": "/path/to/project/.claude/skills",
  "installed": [
    { "name": "navigate-app", "description": "...", "category": "read" },
    { "name": "create-page", "description": "...", "category": "edit" }
  ],
  "dryRun": false
}

What gets installed

Skills are installed flat under the target directory — one subdirectory per skill, each containing a SKILL.md file:

.claude/skills/
├── navigate-app/SKILL.md
├── investigate-component/SKILL.md
├── inspect-construct-schema/SKILL.md
├── create-page/SKILL.md
├── add-region-or-item-to-page/SKILL.md
├── edit-shared-component/SKILL.md
├── delete-component/SKILL.md
└── validate-after-edit/SKILL.md

Existing files are overwritten on each sync, so running sync again always brings you up to date with the latest skill content from the repository.