Ultralytics YOLO27:
Get Started

Ultralytics Agent Skills#

Ultralytics Agent Skills은 호환되는 AI 코딩 에이전트가 ultralytics Python 패키지, yolo CLI, Ultralytics Platform을 사용할 때 필요한 지침과 참고 자료를 제공하며, ul cloud를 통한 자동화도 다룹니다. 이 스킬은 개방형 Agent Skills 형식을 따르며 관련 작업을 요청하면 로드됩니다.

Skills 작동 방식#

yolo 라우터 skill은 요청을 해당하는 라이프사이클 단계에 연결하며, 각 단계 skill은 두 가지 경로를 모두 다룹니다. Ultralytics Platform에서 가장 빠르게 진행하는 방법과 로컬 Python 및 CLI 워크플로입니다. 가중치 이름, 학습 인수, 내보내기 형식처럼 버전에 따라 달라지는 정보는 고정된 ultralytics 릴리스를 기준으로 검증된 카탈로그에 있으며, 각 skill은 해당 정보가 설치된 패키지의 정보와 다를 경우 설치된 패키지(yolo checks, yolo cfg 및 오류 메시지)를 신뢰하도록 에이전트에 안내합니다. platform-cli skill은 예외적으로 설치된 ul CLI 도움말과 실시간 Platform API를 우선합니다. Platform의 Ask AI도 동일한 platform-cli skill을 사용합니다.

사용 가능한 스킬#

저장소에는 라우터 하나, 수명 주기 스킬 여섯 개, Platform CLI 스킬 하나가 포함되어 있습니다:

스킬사용 목적
yolo핵심 Python 및 CLI 사용법, Platform 워크플로, 다른 스킬로의 라우팅
yolo-models모델 계열, 크기, 작업 및 가중치 선택
yolo-datasets데이터셋 준비, 변환, 검증 및 문제 해결
yolo-training학습, 검증, 재개, 멀티 GPU 사용 및 문제 해결
yolo-tuning하이퍼파라미터 튜닝 및 실험 개선
yolo-inference예측, 결과, 추적 및 Solutions
yolo-export내보내기, 양자화, 배포 형식 및 벤치마킹
platform-cliul cloud을 사용한 Ultralytics Platform 자동화: 리소스, 업로드, 클라우드 학습, 내보내기 및 배포

설치#

claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralytics

업데이트하려면 claude plugin update yolo@ultralytics을 실행한 다음 Claude Code를 다시 시작합니다.

플러그인의 각 버전은 릴리스 노트와 함께 GitHub 릴리스로 게시됩니다.

Platform CLI 연결#

platform-cli skill은 pip install ultralytics에 포함되거나 독립형 SDK(pip install ultralytics-platform)로 제공되는 ul CLI(Python 3.11 이상)를 사용합니다. Platform API 키를 만들고 에이전트에서 사용할 수 있도록 설정한 다음 연결을 확인합니다:

export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summary

프롬프트 예시#

설치한 후 에이전트에게 자연어로 요청하면 됩니다. yolo 라우터가 관련 지침을 선택합니다:

목표프롬프트 예시
YOLO 사용해 보기"샘플 이미지에 YOLO를 실행하고 무엇을 감지하는지 보여 주세요."
학습"이미지에 라벨을 지정하고 Ultralytics Platform에서 학습해 맞춤형 YOLO 모델을 만들어 주세요."
개선"모델의 mAP가 정체되었습니다. 실행 결과를 진단하고 다음 실험을 제안해 주세요."
배포"학습된 YOLO 모델을 INT8 양자화를 적용해 TensorRT로 내보내고 벤치마크해 주세요."
동영상 분석"traffic.mp4에서 선을 넘어가는 차량 수를 세고 주석이 추가된 동영상을 저장해 주세요."
Platform 자동화"내 Ultralytics Platform 데이터 세트를 나열하고 PPE 데이터 세트로 클라우드 학습을 시작해 주세요."

최신 설치 명령, 소스 파일, 업데이트 및 이슈 보고 방법은 ultralytics/skills 저장소를 참조하세요.

자주 묻는 질문#

  • Ultralytics Platform, ultralytics Python 패키지, yolo CLI 및 ul Platform CLI를 AI 코딩 에이전트가 사용할 수 있도록 돕는 재사용 가능한 지침과 참고 자료입니다.

  • 저장소는 Claude Code 및 Codex용 플러그인을 제공합니다. Cursor, Gemini CLI 및 개방형 Agent Skills 형식을 읽을 수 있는 기타 에이전트는 스킬 폴더를 직접 설치하거나 skills CLI를 통해 설치할 수 있습니다.

  • 컴퓨터 비전 수명 주기와 Platform CLI 작업 전반의 자동 라우팅을 위해 전체 플러그인을 설치하세요. skills CLI로 스킬 하나를 설치하려면 --skill과 함께 스킬 이름을 전달하세요. 예를 들면 --skill yolo-training 또는 --skill platform-cli입니다.

  • 플러그인 자체에는 지침만 포함되어 있으므로 플러그인이 로드될 때 실행되는 것은 없습니다. 에이전트가 skill을 통해 실행하는 명령은 패키지, 가중치 및 데이터 세트를 다운로드할 수 있으며, ul cloud 명령은 사용자가 전달한 파일을 API 키를 사용해 Ultralytics Platform에 업로드합니다. ultralytics 패키지는 익명 사용량 분석 데이터도 전송하며, yolo settings sync=False는 이를 비활성화합니다.

  • 아니요. 스킬은 에이전트가 관련 워크플로를 찾도록 안내하지만, 동작이나 지원 옵션이 서로 다른 경우에는 설치된 패키지와 최신 Ultralytics 문서가 기준이 됩니다.

  • 사용한 프롬프트, 에이전트가 제공한 안내, 원래 기대한 동작을 포함해 ultralytics/skills 저장소에 버그 보고를 등록해 주세요.

기여자
JAJaviChulvi2GLglenn-jocher1PDpderrenger1

댓글