AI 로 빌드하기 (Build with AI)¶
CrewAI는 태생부터 AI-native예요. 이 페이지는 AI 코딩 에이전트와 함께 CrewAI로 프로젝트를 만들 때 필요한 모든 것 — 스킬(skills), 기계가 읽을 수 있는 문서, 배포, 엔터프라이즈 기능 — 을 한자리에 모아둔 진입점입니다. Claude Code, Codex, Cursor, Gemini CLI처럼 개발자를 도와주는 어떤 어시스턴트든 CrewAI로 크루(crews)와 플로우(flows)를 만들 때 이 페이지를 기준으로 출발하면 돼요.
이 페이지는 사람과 AI 에이전트 모두가 읽을 수 있게 설계됐어요. 에이전트라면 먼저 Skills로 CrewAI 맥락을 잡고, 그다음
llms.txt로 전체 문서에 접근하세요.
개념 — 에이전트에게 CrewAI를 가르치는 방법¶
핵심 아이디어는 간단해요. 매번 세션마다 프레임워크를 처음부터 다시 설명해서 에이전트를 지치게 만들지 말고, 스킬(skills) 이라는 지시 패키지를 주는 거죠. 스킬은 에이전트에게 CrewAI에 대한 깊은 지식을 주입해요 — 플로우를 어떻게 스캐폴딩하는지, 크루를 어떻게 설정하는지, 도구를 어떻게 쓰는지, 프레임워크 관례를 어떻게 따르는지까지요.
스킬 팩이 에이전트에게 가르치는 것:
- Flows — 상태를 가진 앱, 단계(step), 크루 킥오프(kickoff)
- Crews & Agents — JSON 우선 패턴(
crew.jsonc,agents/*.jsonc), 역할, 태스크, 위임(delegation) - Tools & Integrations — 검색, API, MCP 서버, 흔히 쓰는 CrewAI 도구
- Project layout — CLI 스캐폴드와 저장소 관례
- 최신 패턴 — 현재 CrewAI 문서와 모범 사례를 따라감
코드 스니펫 — 스킬 설치하기¶
설치 방법은 두 가지인데, 둘 다 공식 crewAIInc/skills 팩을 설치해요.
Claude Code 플러그인 마켓플레이스 — AI-native 기업들이 쓰는 것과 같은 유통 채널이에요:
/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins
이렇게 하면 에이전트가 관련 질문을 할 때 스킬 네 개가 자동으로 활성화돼요. 어떤 상황에서 어떤 스킬이 도는지가 핵심이에요:
| 스킬 | 언제 동작하나요 |
|---|---|
getting-started |
새 프로젝트 스캐폴딩, LLM.call() / Agent / Crew / Flow 중 무엇을 쓸지 선택, crew.jsonc / main.py 연결 |
design-agent |
에이전트 설정 — role, goal, backstory, tools, LLMs, memory, guardrails |
design-task |
태스크 설명 작성, 의존성, 구조화된 출력(output_pydantic, output_json), 사람 검토(human review) |
ask-docs |
실시간 CrewAI 문서 MCP 서버를 조회해 최신 API 세부사항을 얻기 |
npx (모든 에이전트) — Claude Code, Codex, Cursor, Gemini CLI, 어떤 코딩 에이전트에서도 동작해요:
skills.sh 레지스트리에서 가져옵니다. 두 방법 모두 같은 내용을 설치하므로 편한 쪽을 골라 쓰면 돼요.
실무 관점 — 설치하고 나서¶
스킬 팩을 설치하는 순간 에이전트는 즉시 CrewAI 전문가가 돼요. "지금 뭘 만들고 싶어?" 같은 질문에 에이전트가 스캐폴드부터 시작해 크루와 플로우를 직접 조립해 주는 거죠. 매 세션마다 프레임워크를 다시 설명할 필요가 사라지니까, 반복 작업이 줄고 에이전트의 답변이 훨씬 일관성을 가지는 게 가장 크게 체감되는 변화예요.
한 가지 짚고 갈 점은 설치 방식에 따라 활성화 경로가 조금 다르다는 거예요. Claude Code 마켓플레이스 방식은 /reload-plugins가 있어서 플러그인을 다시 불러오는 단계가 따로 있고, npx 방식은 그런 재로딩 없이 바로 레지스트리에서 받아오죠. 하지만 결과는 같으니, 자신이 쓰는 에이전트에 맞는 명령을 그대로 실행하면 돼요.
더 알아보기¶
- Skills 개념 — CrewAI 에이전트에서 스킬이 어떻게 동작하는지, 주입·활성화·패턴
- Skills 랜딩 페이지 —
crewAIInc/skills팩 개요와 포함 내용 - llms.txt — 전체 문서 인덱스. 스킬로 맥락을 잡은 뒤 전체 문서를 탐색할 때 접근하세요.