Agent Skill Cast

Cast your AI agent skills across your team.


---

Why?

> "I made a useful skill on the mobile branch, but I want to use it on main too... cherry-picking is such a pain..."
>
> "Repo A and B are both React projects, and 90% of skills are identical. Managing copies is hell..."

Don't let skills be tied to branches or repos.

Agent Skill Cast lets you pick only the skills you need from a central repository and cast them into your project.

---

Features

| | |
|---|---|
| Selective Sync | Pick only the skills you need, not the entire repository |
| Multi-Agent | Auto-manages Claude, Gemini, Codex folders |
| Instant Updates | cast source sync keeps everything up-to-date |
| Local & Remote | Supports both Git repos and local folders |

---

Installation

``bash
npm install -g agent-skill-cast
`

> Requires Node.js

---

Quick Start

$3

`bash
cast init
`

$3

`bash

GitHub repository

cast source add https://github.com/my-team/shared-skills

Or local folder

cast source add ~/my-personal-skills
`

$3

`bash
cast use

Interactive menu - select skill numbers (comma-separated for multiple)

`

$3

`bash
cast list

Symlinks created in .claude/skills/

`

$3

`bash
cast source sync
`

---

Commands

$3

| Command | Description |
|---------|-------------|
| cast init | Initialize global configuration |
| cast use | Select and install skills (interactive) |
| cast use / | Install a specific skill directly |
| cast list | Show installed skills |
| cast remove | Remove a skill |

$3

| Command | Description |
|---------|-------------|
| cast source | Source Management Menu (Interactive) |
| cast source add | Register a source |
| cast source list | Show registered sources |
| cast source remove | Unregister a source |
| cast source sync | Update sources and refresh skills |

$3

| Option | Description |
|--------|-------------|
| --claude | Install only to .claude/skills |
| --gemini | Install only to .gemini/skills |
| --codex | Install only to .codex/skills |

$3

`bash
cast config # Configuration Menu (Interactive)
cast config lang ko # 한국어
cast config lang en # English
`

---

How It Works

`
┌─────────────────────────────────────────────────────────┐
│ Skill Source Repository (GitHub / Local) │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ ~/.asc_sources/ │
│ └── shared-skills/ ← git clone or symlink │
│ ├── react-patterns/ │
│ ├── testing-guide/ │
│ └── mobile-helper/ │
└─────────────────────────────────────────────────────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
Project A Project B Project C
.claude/ .claude/ .claude/
skills/ skills/ skills/
↓ ↓ ↓
[symlink] [symlink] [symlink]
`

- Zero Copy: Symlinks save disk space
- Instant Reflect: Source updates apply to all projects automatically
- Independent Selection: Each project can have different skill combinations

---

Skill Structure

To identify a folder as a skill, it must contain a SKILL.md file.
Agent Skill Cast searches for skills in the following locations within a source repository:

1. Root Directory: Any folder containing SKILL.md.
- my-skill/SKILL.md → Identified as my-skill
2. Agent Specific Directories:
- .claude/skills/my-skill/SKILL.md
- .gemini/skills/my-skill/SKILL.md
- .codex/skills/my-skill/SKILL.md

> Note: Folders without SKILL.md are ignored.

---

Collaboration Scenarios

Scenario 1: Sharing Skills Across Branches

> Situation: You made a skill on the mobile branch and want to use it on main.

`bash

Register skill repository (once)

cast source add https://github.com/my-team/shared-skills

Use from any branch

cast use shared-skills/mobile-helper

Sync when updated

cast source sync
`







Scenario 2: Sharing Skills Across Repositories

> Situation: Repo A and B use the same frontend tech, 90% skills are identical.

`bash

Both Repo A and B:

cast source add https://github.com/my-team/frontend-skills
cast use frontend-skills/react-patterns
cast use frontend-skills/testing-guide
`

Update the source once, cast source sync syncs all repos!







Scenario 3: Instantly Share with Teammates

> Situation: You want to quickly share a new skill with your team.

`bash

1. Push to skill repository

cd ~/shared-skills
mkdir new-skill && echo "..." > new-skill/SKILL.md
git add . && git commit -m "feat: add new skill" && git push

2. Tell teammates: "Run cast source sync!"

3. Teammates

cast source sync
cast use shared-skills/new-skill
``

---

License

MIT