Agent Skill Cast - Selective Skill Sync & Source Management
npm install agent-skill-castcast source sync keeps everything up-to-date |
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
``