Skills
Atlas Cloud Agent Skills를 설치하여 Claude Code, Codex CLI, Gemini CLI에서 Atlas Cloud API로 이미지, 동영상, 오디오, 3D를 생성하세요.
Skills란?
Skills는 AI 코딩 에이전트에게 특정 도메인 — API 레퍼런스, 파라미터 규칙, 모델 선택 기준, 동작하는 코드 템플릿 — 을 가르치는 재사용 가능한 지식 패키지입니다. Atlas Cloud skill을 설치하면 에이전트가 Atlas Cloud API를 정확하게 이해하여, 일상적인 언어로 된 지시만으로 이미지, 동영상, 오디오, 3D 모델을 생성하고 올바른 통합 코드를 작성할 수 있습니다.
Atlas Cloud Skills는 Claude Code, OpenAI Codex CLI, Gemini CLI를 비롯해 동일한 skill 형식을 지원하는 다른 에이전트에서 사용할 수 있습니다.
GitHub 저장소: AtlasCloudAI/atlas-cloud-skills
포함 내용
저장소에는 세 가지 skill이 포함되어 있습니다:
atlas-cloud
핵심 skill. 이미지, 동영상, 오디오, 3D, LLM 채팅, 미디어 업로드, 모델 검색에 대한 완전한 API 레퍼런스.
seedance-2-5-skill
Seedance 2.5 전용 skill — 스토리보드, 멀티모달 레퍼런스, 네이티브 오디오·비디오 생성.
universal-video-prompt-skill
모델에 구애받지 않는 동영상 프롬프트 작성: 대략적인 아이디어를 샷 단위의 구조화된 프롬프트로 바꿉니다.
핵심 skill의 구성
atlas-cloud는 진입점인 SKILL.md와, 에이전트가 필요할 때 불러오는 7개의 레퍼런스 문서로 구성되어 있습니다:
| 레퍼런스 | 다루는 내용 |
|---|---|
references/image-gen.md | 3D 모델을 포함한 이미지 생성 |
references/video-gen.md | 동영상 생성, 립싱크, 토킹 아바타 |
references/audio-gen.md | 텍스트 음성 변환, 음악 생성, 음성 인식 |
references/llm-chat.md | OpenAI 호환 채팅 완성 |
references/quick-generate.md | 모델을 자동으로 골라주는 원스텝 생성 |
references/upload.md | 이미지-투-비디오 및 편집 워크플로를 위한 로컬 파일 업로드 |
references/models.md | 모델 검색, 요금, 기능 조회 |
레시피 라이브러리
skill 자체 외에도, 저장소에는 에이전트가 그대로 따라 할 수 있는 엔드투엔드 워크플로인 25개의 완성된 레시피가 들어 있습니다:
| 카테고리 | 레시피 수 | 예시 |
|---|---|---|
library/visual | 7 | 제품 사진, 포스터 디자인, 스타일 트랜스퍼 |
library/motion | 6 | 제품 렌더링을 광고로, 캐릭터를 드라마 장면으로 |
library/edit | 6 | 배경 제거, 오브젝트 정리, 업스케일링 |
library/social | 6 | 롱폼 동영상을 세로형 쇼츠로, 썸네일 생성 |
설치
세 가지 skill을 모두 설치:
npx skills add AtlasCloudAI/atlas-cloud-skills단일 skill 설치:
npx skills add AtlasCloudAI/atlas-cloud-skills --skill atlas-cloud설정
API 키를 환경 변수로 설정하세요:
export ATLASCLOUD_API_KEY="your-api-key"터미널 세션 간에 유지하려면 셸 프로필(~/.bashrc, ~/.zshrc 등)에 이 줄을 추가하세요.
키는 Atlas Cloud 대시보드에서 생성할 수 있습니다. 자세한 내용은 API 키를 참조하세요.
에이전트는 여러분을 대신해 셸 명령을 실행합니다. 키는 환경 변수나 시크릿 매니저에 보관하세요 — 저장소에 커밋하거나 프롬프트에 붙여 넣지 마세요.
사용 예제
설치한 뒤에는 원하는 바를 자연어로 설명하면 됩니다:
이미지와 3D
"Seedream v5.0 Pro로 리넨 배경 위에 놓인 도자기 머그컵 제품 사진을 생성해줘"
"이 사진을 Blender에서 열 수 있는 3D 모델로 변환해줘"
동영상
"Seedance 2.5로 골든아워의 바다 파도를 담은 5초 클립을 만들어줘"
"이 제품 렌더링으로 내레이션이 들어간 15초 광고를 만들어줘"
오디오
"이 문단을 따뜻한 여성 목소리로 읽어서 MP3로 저장해줘"
"여름 로드트립을 주제로 한 90초짜리 경쾌한 팝 트랙을 작사하고 생성해줘"
"이 인터뷰 녹음을 전사해서 화자별로 구분된 텍스트로 만들어줘"
LLM과 모델 검색
"DeepSeek V3.2에게 이 파일의 보안 이슈를 검토해달라고 해줘"
"레퍼런스 이미지를 지원하는 동영상 모델은 무엇이고 요금은 얼마야?"
지원 기능
| 기능 | 엔드포인트 | 예시 모델 |
|---|---|---|
| 이미지 생성 | POST /api/v1/model/generateImage | Seedream v5.0 Pro, FLUX 2, Qwen Image 3.0 |
| 3D 생성 | POST /api/v1/model/generateImage | Hunyuan3D Pro, Seed3D 2.0, Tripo H3.1 |
| 동영상 생성 | POST /api/v1/model/generateVideo | Seedance 2.5, Kling, Wan 3.0, Veo |
| 음성 합성 | POST /api/v1/model/generateAudio | Seed Audio 1.0, ElevenLabs, MiniMax Speech |
| 음악 생성 | POST /api/v1/model/generateAudio | Suno Chirp v5, MiniMax Music 3.0 |
| 음성 인식 | POST /api/v1/model/generateAudio | Seed ASR 2.0, xAI STT v1 |
| LLM 채팅 | POST /v1/chat/completions | DeepSeek, Qwen, Kimi, GLM, MiniMax |
| 미디어 업로드 | POST /api/v1/model/uploadMedia | 로컬 파일을 호스팅 URL로 |
| 모델 검색 | 카탈로그 조회 | 이름, 유형, 제공업체로 검색 |
Skills와 MCP 서버 중 무엇을 쓸까?
둘 다 Atlas Cloud를 개발 환경으로 가져오지만, 해결하는 문제가 다릅니다:
| Skills | MCP 서버 | |
|---|---|---|
| 호환 도구 | Claude Code, Codex CLI, Gemini CLI 등 skill을 인식하는 에이전트 | Claude Code, Cursor, Claude Desktop, VS Code, Windsurf, Cline 등 |
| 제공하는 것 | 도메인 지식, 파라미터 규칙, 코드 템플릿 | 에이전트가 직접 호출하는 실행 가능한 도구 |
| 설정 | 명령어 한 줄 | 클라이언트별 JSON 또는 TOML 설정 |
| 적합한 용도 | 통합 코드 작성, 여러 단계의 크리에이티브 워크플로 | 에디터를 벗어나지 않고 생성 실행 |
둘 다 사용하세요. MCP 서버가 호출을 실행하고, Skills는 어떤 모델을 고르고 어떤 파라미터가 실제로 중요한지를 에이전트에게 알려줍니다.
설정 방법은 MCP 서버 가이드를 참조하세요.
DeepSeek Harness에서 skill 사용하기
DeepSeek Harness를 사용한다면, dsh-media-gen 번들이 이 skill들을 프로필 플러그인으로 패키징해 제공합니다:
dsh plugin --profile web add 'github:AtlasCloudAI/dsh-media-gen#v0.2.0'
export ATLASCLOUD_API_KEY="your-api-key"이 번들은 업스트림 skill을 따라가며, 필요하면 Atlas Cloud MCP 서버를 함께 활성화할 수도 있습니다.
관련 문서
Last updated on