#agconf

rsync for AI agent configs — copy skills, prompts, and commands from GitHub repos to your agent directories.

#Motivation

#Quick Start

# 从 GitHub 仓库安装一个 skill
agconf fetch https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design

# 安装一个 prompt 到指定 agent
agconf fetch https://github.com/owner/repo/blob/main/prompts/review.md -a pi

# 用完整 URL 指定一个 skill
agconf fetch https://github.com/user/repo/blob/main/skills/foo/SKILL.md

# skill 转 prompt
agconf fetch https://github.com/owner/repo/tree/main/skills/web-design --as-prompt -a codex -g

# 全局安装
agconf fetch https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design -g

# 预览
agconf fetch https://github.com/owner/repo/tree/main/skills/web-design --dry-run

#Install

brew install kkkiio/tap/agconf

moon install KKKIIO/agconf

moonx KKKIIO/agconf fetch -g https://github.com/kkkiio/skills/tree/main/skills/write-agents-md

#How It Works

Source (GitHub repo)  ─→  [--as-prompt?]  ─→  Agent config dir

#内容识别

#输出路径规则

• Skill 未指定 -a 时写入标准目录：项目级 .agents/skills/，加 -g 时为 ~/.agents/skills/。
• Prompt 未指定 -a 时仍尝试所有支持的 agent；不支持的目标会 warning 并跳过。
• Skills → 按 agent 写入 skills 目录。
• Prompts / commands → 按 agent 写入 prompts 目录。不支持的 agent 跳过并 warning。
• --as-prompt 将 skill 转为 prompt，写入对应 agent 的 prompts 目录。

#Agent 路径映射

Codex prompts 仅支持全局（~/.codex/prompts/）。未传 -g 时跳过并 warning。 universal 仅支持 skills，无 prompts 路径。安装 prompts 时跳过 universal 并 warning。

#Usage

agconf fetch <source> [options]

Sources:
  https://github.com/owner/repo                         完整仓库 URL
  https://github.com/owner/repo/tree/main/skills/foo    tree URL（子目录）
  https://github.com/owner/repo/blob/main/SKILL.md      blob URL（单个文件）
  ./local-path                                          本地路径

Options:
  -a, --agent <agent>   目标 agent（可重复：-a pi -a codex）
                        Skill 默认写入标准 .agents/skills/ 目录；
                        Prompt 默认尝试所有支持的 agent。
  -g, --global          安装到用户级目录
  --as-prompt           将 SKILL.md 转为单文件 prompt（去 frontmatter，
                        以 skill 目录名作为文件名）
  --ref <branch|tag>    指定 GitHub 分支或 tag（默认 HEAD）
  --dry-run             预览操作，不实际写入
  --conflict <mode>     冲突策略：overwrite（默认）| skip | ask

#--as-prompt

• 去掉 YAML frontmatter（--- 块）
• 保留正文 Markdown 内容
• 以 skill 目录名（而非 SKILL）作为输出文件名
• 写入对应 agent 的 prompts 目录

agconf fetch https://github.com/owner/repo/tree/main/skills/web-design --as-prompt -a pi
# 输出: .pi/prompts/web-design.md

#Examples

# 从 GitHub 仓库拉取单个 skill
agconf fetch https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design

# 用完整 URL 指定一个 skill
agconf fetch https://github.com/user/repo/blob/main/skills/foo/SKILL.md

# 指定分支
agconf fetch https://github.com/owner/repo/tree/main/skills/foo --ref develop

# 同一文件输出到多个 agent
agconf fetch https://github.com/owner/repo/blob/main/prompts/review.md -a pi -a codex -g

# skill 转 prompt
agconf fetch https://github.com/owner/repo/tree/main/skills/web-design --as-prompt -a pi

# 全局安装
agconf fetch https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design -g

# Codex prompt 需要加 -g（否则跳过）
agconf fetch https://github.com/owner/repo/blob/main/prompts/review.md -a codex -g

# 预览
agconf fetch https://github.com/vercel-labs/agent-skills --dry-run

#Source Conventions

source/
├── skills/
│   └── <name>/
│       └── SKILL.md          ← skill（含 YAML frontmatter）
├── commands/
│   └── <name>.md             ← command / prompt
└── prompts/
    └── <name>.md             ← prompt

#License