온보딩 스킬

온보딩 스킬 (Onboarding Skill)

조직의 프로젝트에 코딩 에이전트가 온보딩할 때 받게 되는 기본 Custom Agent Skill을 정의하는 설정이에요. 조직 관리자는 Claude Code, Codex, Cursor, Windsurf 같은 Agent Skills 표준을 지원하는 도구들이 Confident AI에서 스킬을 설치할 때 어떤 기본 스킬을 받을지 정할 수 있어요.

출처: 문서

본문

**Onboarding Skill(온보딩 스킬)**을 사용하면 조직 관리자가 Confident AI에서 스킬을 설치하는 코딩 에이전트들이 받게 될 기본 Custom Agent Skill을 정의할 수 있어요. 이 스킬에는 저장소 규칙, 설정 명령어, 테스트·평가 워크플로, 트레이싱 기대치, 팀별 지시사항 등을 담을 수 있어요.

Organization Onboarding Skill

온보딩 스킬 구성하기 (Configure the onboarding skill)

조직 온보딩 스킬을 구성하려면 이렇게 해요.

  1. Organization Settings(조직 설정) → Onboarding Skill로 이동
  2. Install skills repo 명령어를 확인
  3. 스킬이 코딩 에이전트를 어떻게 안내해야 하는지를 요약한 Description(설명) 입력
  4. Skill Body에 전체 마크다운 내용 추가
  5. Save(저장) 클릭

Description은 SKILL.md의 프론트매터(frontmatter) 설명이 되고, Skill Body는 코딩 에이전트가 읽고 따르게 되는 마크다운 본문이 돼요.

스킬 설치하기 (Install the skill)

Onboarding Skill 페이지에는 조직의 스킬 저장소 설치 명령어가 표시돼요.

npx skills add "https://apikey:PROJEC...git" --skill onboarding

PROJECT_API_KEY는 제품 팀이 작업 중인 프로젝트의 Project API Key로 바꿔 주세요.

--skill onboarding 플래그는 Skills CLI가 저장소에서 온보딩 스킬을 설치하도록 하는 필수 옵션이에요.

Project API Key가 어떤 프로젝트별 스킬을 제공할지 결정해요. 프로젝트에 자체 온보딩 스킬이 없으면 Confident AI는 이 페이지에서 구성한 조직 온보딩 스킬로 대체(fallback)해요.

무엇을 포함할까 (What to include)

좋은 온보딩 스킬은 코딩 에이전트가 팀마다 같은 설정 질문을 반복하지 않고도 유용한 변경을 만들 수 있을 만큼 충분한 맥락을 줘요. 다음과 같은 지시사항을 포함해 보세요.

  • 필수 설정·의존성 설치 명령어
  • 테스트, 평가, 린터, 타입 체크를 실행하는 방법
  • 저장소 규칙과 코드 소유권 기대치
  • 트레이스를 계측하고 결과를 Confident AI로 보내는 방법
  • 특별히 주의가 필요한 파일이나 워크플로
  • 제품 팀이 코딩 에이전트에 사용해야 하는 프롬프트 예시

조직 레벨의 온보딩 스킬은 여러 팀에 걸쳐 적용될 수 있도록 충분히 넓게 유지하세요. 프로젝트에 특수한 명령어·아키텍처·릴리스 요구사항이 있을 때만 프로젝트별 온보딩 스킬을 쓰는 편이 좋아요.

Custom Agent Skills Guide

프로젝트별 온보딩·거버넌스 지시사항을 Confident AI에서 제공하도록 구성해요.

Organization Projects

Project API Keys로 스킬을 해석하는 프로젝트들을 관리해요.

더 알아보기 (Learn more)