agent-operate

herdr·Orca 같은 터미널 멀티플렉서 안에서 코딩 에이전트(Claude Code·Codex·OpenCode·Hermes)를 띄우고 다루는 Claude Code 스킬 모음이다. Claude Code 플러그인 마켓플레이스 형식이라 명령 두 줄로 다른 맥에 설치한다.

들어 있는 스킬

플러그인 스킬은 앞에 플러그인 이름(agent-operate:)이 붙는다. 이 접두어는 뺄 수 없다.

설치

Claude Code 세션 안에서:

/plugin marketplace add vriznet/agent-operate
/plugin install agent-operate@agent-operate

셸에서:

claude plugin marketplace add vriznet/agent-operate
claude plugin install agent-operate@agent-operate

설치한 뒤 Claude Code를 다시 시작하면 스킬이 보인다.

opencode·Codex 등 다른 에이전트

Claude Code 플러그인은 Claude Code만 읽는다. opencode·Codex 같은 다른 에이전트에는 같은 저장소를 skills CLI로 깐다(~/.agents/skills에 받고 각 에이전트 폴더에 링크한다).

npx skills add vriznet/agent-operate -g -a opencode -a codex -y          # 스킬 전부
npx skills add vriznet/agent-operate -g -a opencode -s herdr-council -y   # 하나만
npx skills update -g                                                       # 갱신

• Claude Code에는 skills CLI로 깔지 않는다(-a claude-code를 빼고 에이전트를 골라 준다). 플러그인과 함께 깔면 /herdr-council과 /agent-operate:herdr-council처럼 두 벌로 보인다.
• 스킬 글 속 호출 이름(/agent-operate:)은 Claude Code 기준이다. 다른 에이전트에서는 스킬 이름(herdr-council 등)으로 부른다.
• 스크립트가 있는 스킬은 ${CLAUDE_SKILL_DIR}로 자기 폴더를 가리킨다. Claude Code만 이 값을 실제 경로로 바꿔 주므로, 다른 에이전트에서는 SKILL.md가 있는 폴더 경로로 바꿔 쓰라고 스킬마다 적어 두었다.

여러 맥에 같은 설정 두기

~/.claude/settings.json에 아래 두 항목을 넣어 두면 마켓플레이스와 사용 설정이 함께 따라간다. 처음 한 번은 그 맥에서 claude plugin install agent-operate@agent-operate를 실행해야 내려받는다.

{
  "extraKnownMarketplaces": {
    "agent-operate": {
      "source": { "source": "github", "repo": "vriznet/agent-operate" }
    }
  },
  "enabledPlugins": {
    "agent-operate@agent-operate": true
  }
}

갱신

Claude Code에서 /agent-operate:update를 부르면 아래 일을 대신 하고 결과를 알려 준다(skills CLI로 깐 스킬까지 함께 갱신한다).

직접 만든 마켓플레이스는 자동 갱신이 기본으로 꺼져 있다. 새 판을 받으려면:

claude plugin marketplace update agent-operate
claude plugin update agent-operate@agent-operate

자동으로 받고 싶으면 /plugin → Marketplaces → agent-operate에서 자동 갱신을 켠다.

예전에 ~/.claude/skills에 직접 넣어 둔 사본

같은 스킬을 ~/.claude/skills/에도 두면 /herdr-worktree-quad와 /agent-operate:herdr-worktree-quad처럼 두 벌로 보인다. 플러그인이 동작하는 것을 확인한 뒤 옛 사본을 지운다.

함께 쓰면 좋은 외부 스킬

아래 스킬은 이 저장소에 넣지 않았다. 원저자 저장소에서 skills CLI로 받는다(-g는 사용자 전역 설치, -y는 확인 생략).

skills CLI는 ~/.agents/skills에 내려받고 Claude Code가 읽는 ~/.claude/skills에 링크를 건다. 받은 뒤 npx skills update로 갱신한다.

개발

• 스킬 하나 = skills//SKILL.md 폴더 하나. 폴더를 더하면 따로 등록하지 않아도 플러그인에 들어간다.
• 스킬이 자기 폴더의 파일을 부를 때는 ${CLAUDE_SKILL_DIR}를 쓴다(예: node "${CLAUDE_SKILL_DIR}/scripts/quad.mjs"). 설치 위치가 맥마다 달라서 ~/.claude/skills/...처럼 경로를 박으면 안 된다.
• 내기 전에 형식을 검사한다: claude plugin validate .
• 판을 올릴 때는 .claude-plugin/plugin.json과 marketplace.json의 version을 함께 올린다. 다른 맥은 판이 바뀌어야 새 내용을 받는다.
• 로컬에서 시험: claude --plugin-dir .로 띄우면 설치하지 않고 이 폴더의 스킬을 읽는다.

라이선스

MIT. LICENSE 참고.