agent-skill-cast - SKILL.md Agent Skill

name: agent-skill-cast description: CLI to sync AI skills from git repos to local .claude/.gemini/.codex folders. allowed-tools: Bash

Agent Skill Cast (ASC) Interface

⚠️ CI Mode (Required for Agents)

All commands MUST use --ci flag. Interactive prompts are disabled in CI mode. Add --json for machine-readable output. --json is supported across all commands.

CI mode is auto-activated when:

--ci flag is present
stdin is not a TTY (e.g. piped execution)

Syntax

cast <command> [arguments] --ci [--json] [--copy]

Commands

Source Management

cast source add <url|path> --ci: Register a git repo or local folder source.
cast source sync --ci: Update all sources to latest. Required before use.
cast source list --ci [--json]: Show registered sources.
cast source remove <name> --ci: Unregister a source.

Skill Operations

cast init --ci: Initialize ASC in current project (creates config).
cast list --ci [--json]: Show skills currently installed in this project.
cast use <source>/<skill> --ci [--copy]: Install a specific skill.
- Flags: --claude, --gemini, --codex (Target specific agent. Default: all), --copy (install standalone copies instead of symlinks).
cast remove <skill> --ci: Uninstall a skill.

Configuration

cast config lang <en|ko> --ci: Set CLI language.

Rules

ALWAYS use --ci flag. Never omit it.
ALWAYS provide required arguments explicitly. Never rely on interactive prompts.
Use --json when you need to parse the output programmatically.
Run cast source sync --ci before cast use if sources haven't been synced.

JSON Output Format

When --json is used, output follows this structure:

{ "ok": true, "data": { ... } }
{ "ok": false, "error": "error_key", "message": "Human readable message" }

Exit Codes

0: Success
1: Execution error (source not found, skill not found, etc.)
2: Argument error (missing required argument in CI mode)

Example Workflow

cast init --ci
cast source add https://github.com/my-team/frontend-skills --ci
cast source sync --ci
cast use frontend-skills/react-patterns --gemini --ci
cast use frontend-skills/testing-guide --copy --ci
cast list --ci --json