the-controller-synchronizing-skills

Synchronize Git repository skill directories to agent home directories via symbolic links.

13|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/kwannoel/the-controller --skill the-controller-synchronizing-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: the-controller-synchronizing-skills
Source: https://github.com/kwannoel/the-controller/tree/main/skills/the-controller-synchronizing-skills
Command: npx skills add https://github.com/kwannoel/the-controller --skill the-controller-synchronizing-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of making new skills discoverable by AI agents like Claude Code and Codex, ensuring they are correctly linked into the agent's environment.

Core Features & Use Cases

  • Symlinking Skills: Creates symbolic links for skill directories from the repository into the agent's custom skill directories (~/.claude/skills/ and ~/.codex/skills/custom/).
  • Automated Updates: Handles adding new skills, removing stale links, and ensuring existing links point to the correct source.
  • Use Case: After adding a new skill to the repository, run this script to immediately make it available for use by your AI coding assistants without manual file management.

Quick Start

Run the sync script from anywhere inside the repo to update agent skill directories.

Frequently Asked Questions about the-controller-synchronizing-skills

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

FAQPage Schema
How do I sync custom skills to Claude Code and Codex agent directories?

To sync custom skills to agent directories, this script creates symbolic links from your Git repository into `~/.claude/skills/` and `~/.codex/skills/custom/`, making new skills immediately discoverable by AI coding assistants.

How do I automate making new skills discoverable by AI agents without manual copying?

Automating skill discovery is done by running the sync script from anywhere inside the repository, which resolves the Git root and creates symbolic links to the agent home directories, adding new skills and removing stale links automatically.

Do I need Git installed to symlink skills into agent custom skill directories?

Yes, Git is required to resolve the repository root path when symlinking skills into agent custom skill directories, and bash scripting is used to perform the file system operations for creating and managing those links.

What happens to stale symbolic links when I remove a skill from the repository?

When a skill is removed from the repository, the automated sync script handles cleanup by removing stale symbolic links from the agent directories and ensures existing links point to the correct source.

Can I use this skill synchronization script for managing custom skill sets at scale?

You can use this skill synchronization script for managing custom skill sets for AI agents like Claude Code and Codex, as it handles adding new skills, removing stale links, and updating existing links across agent environments.

Why are my custom skills not showing up in the Claude Code skills directory?

Custom skills may not show up in the Claude Code skills directory if the symbolic links are missing or pointing to the wrong source; running the sync script from inside the repo updates and corrects these links.