코딩 에이전트용 플러그인

코딩 에이전트용 플러그인 (Plugins for Coding Agents)

공식 스킬을 Claude Code, Cursor, Codex 마켓플레이스의 플러그인으로 설치하는 방법을 설명하는 문서예요. 이 문서에서는 사용 가능한 플러그인, 클라이언트별 설치 명령, 그리고 자주 묻는 질문을 정리해 볼게요.

출처: 문서

본문

개요 (Overview)

Confident AI의 Agent Skills은 플러그인으로도 배포돼요. 플러그인은 Claude Code, Cursor, Codex가 스킬을 플러그인 마켓플레이스로 배포할 때 쓰는 패키징 형식이에요. 플러그인은 얇은 래퍼(wrapper)로, SDK 저장소 안에서 skills/ 폴더를 가리키는 매니페스트예요. 그래서 플러그인을 설치하면 저장소의 모든 스킬이 한 번에 설치되고, 클라이언트가 마켓플레이스를 통해 계속 업데이트해 줘요.

이미 스킬을 개별로 설치했다면(예: npx skills add), 플러그인은 필요 없어요. 둘 다 같은 SKILL.md 파일을 제공하니까요. 원클릭 설치, 팀 전체 배포, 또는 클라이언트 내장 업데이트 흐름을 원할 때 플러그인이 더 나은 선택이에요.

사용 가능한 플러그인

각 저장소는 그 자체로 플러그인 마켓플레이스가 돼요. Confident Trace는 confident-trace-plugins, DeepEval은 deepeval-plugins, Admin SDK는 confident-ai-plugins를 갖고 있어서, 저장소를 마켓플레이스 소스로 한 번 추가한 뒤 플러그인 이름으로 설치하면 돼요.

Claude Code

저장소를 마켓플레이스로 추가하고, 플러그인을 설치하고, 다시 로드해요:

confident-trace

/plugin marketplace add confident-ai/confident-trace
/plugin install confident-trace@confident-trace-plugins
/reload-plugins

deepeval

/plugin marketplace add confident-ai/deepeval
/plugin install deepeval@deepeval-plugins
/reload-plugins

confident-client

/plugin marketplace add confident-ai/confident-client
/plugin install confident-client@confident-ai-plugins
/reload-plugins

그 다음 /plugins를 실행해 설치된 플러그인 아래에 표시되는지 확인해요.

Cursor

세 저장소 모두 Cursor 플러그인 매니페스트(.cursor-plugin/plugin.json)를 담고 있어요. Cursor의 Customize 패널에서 플러그인 검색에 저장소 URL을 붙여 넣어 설치하거나, Claude Code가 쓰는 것과 같은 마켓플레이스 명령으로 채팅에서 설치해요:

/plugin marketplace add https://github.com/confident-ai/confident-trace

DeepEval이나 Confident Client 플러그인은 해당 저장소 URL로 바꿔 넣으면 돼요. 설치되면 Cursor가 저장소 skills/ 폴더의 모든 스킬을 자동으로 발견해요. 에이전트가 일치하는 프롬프트에서 스킬을 활성화하거나, / 다음에 스킬 이름을 타이핑해 명시적으로 호출할 수도 있어요.

저장소 URL에서 직접 설치하면 Cursor의 큐레이티드 마켓플레이스 검토를 건너뛰게 돼요. 저장소 자체를 신뢰하는 건데, 이 경우 SDK가 배포되는 것과 같은 Confident AI 저장소예요.

Codex

confident-trace 저장소는 skills/ 폴더를 가리키는 Codex 플러그인 매니페스트(.codex-plugin/plugin.json)를 담고 있어서, 플러그인이 설치되면 Codex가 두 트레이싱 스킬을 모두 발견해요. 스킬 폴더를 .agents/skills/에 직접 복사할 수도 있어요:

git clone https://github.com/confident-ai/confident-trace
mkdir -p .agents/skills/
cp -r confident-trace/skills/confident-tracing .agents/skills/

confident-client 저장소는 자체 Codex 마켓플레이스 파일(.agents/plugins/marketplace.json)을 담고 있어요. 저장소를 마켓플레이스 소스로 등록한 뒤 이름으로 설치하거나, Codex TUI 안의 /plugins 선택기에서 찾아서 설치해요:

codex plugin marketplace add confident-ai/confident-client
codex plugin add confident-client

DeepEval 저장소는 아직 Codex 플러그인을 배포하지 않아요. Codex의 평가 스킬은 Skills CLI로 설치해요:

npx skills add confident-ai/deepeval --skill "deepeval"

자주 묻는 질문 (FAQs)

이미 스킬을 설치했는데 플러그인도 필요하나요?

아니요. 플러그인은 Skills CLI가 제공하는 것과 같은 SKILL.md 파일을 전달하므로, 둘 다 설치하면 중복돼요. 원클릭 설치와 마켓플레이스 업데이트를 원하면 플러그인을, 단일 스킬 설치나 플러그인 시스템이 없는 클라이언트용이면 Skills CLI를 선택하세요.

플러그인 업데이트는 어떻게 되나요?

클라이언트가 저장소를 마켓플레이스 소스로 추적하므로, 업데이트는 자체 메커니즘을 통해 전달돼요. Claude Code와 Cursor는 마켓플레이스에서 새로고침하고, Codex는 codex plugin marketplace upgrade로 다시 가져와요. 반면 복사나 CLI로 설치한 스킬은 정적 스냅샷이에요.

왜 deepeval용 Codex 플러그인은 없나요?

DeepEval 저장소는 아직 Codex 플러그인 매니페스트를 배포하지 않아요. confident-trace와 confident-client만 배포해요. Codex에서는 배포될 때까지 Skills CLI(npx skills add confident-ai/deepeval --skill "deepeval")로 DeepEval 스킬을 설치하면 돼요.

GitHub 저장소에서 직접 설치하는 게 안전한가요?

저장소 URL에서 설치한다는 건 큐레이티드 마켓플레이스 검토 대신 그 저장소를 신뢰한다는 뜻이에요. 여기서 저장소는 SDK가 배포되는 것과 같은 공개 Apache-2.0 Confident AI 저장소이고, 스킬이 에이전트에게 주는 모든 지침은 설치 전에 저장소에서 읽을 수 있어요.

다음 단계

플러그인은 스킬만 전달해요. 각 스킬은 여전히 자체 사전 조건(confident-trace, deepeval, confidentai 패키지와 올바른 API 키)을 요구해요. 설정할 것과 예시 프롬프트는 각 스킬 페이지를 참고해요:

Agent Skills 개요

각 스킬이 무엇을 하는지, 어떤 API 키가 필요한지, 모든 설치 방법을 나란히 비교해요.

MCP 서버

플러그인을 프로젝트의 트레이스, 데이터셋, 평가에 대한 실시간 액세스와 함께 사용해요.

더 알아보기

• 코딩 에이전트용 스킬
• 코딩 에이전트용 MCP 서버
• Custom Agent Skills 가이드