PixelML/agenticflow-skill

당신의 AI 도구들을 AgenticFlow 플랫폼에 연결하세요.

이 툴킷(toolkit)은 당신의 에이전트(Claude Code, OpenAI Codex, Cursor, Gemini CLI, …)가 AgenticFlow에 접근할 수 있도록 해줍니다: AI 에이전트를 구축하고, 멀티 에이전트 워크포스(multi-agent workforces)를 배포하며, MCP 도구 제공자(tool providers)를 검사 및 연결하고, af CLI를 통해 운영을 자동화할 수 있습니다.

Claude Code— 채팅에서 다음을 실행하세요: /plugin marketplace add PixelML/agenticflow-skill /plugin install agenticflow-plugin@agenticflow-ai-toolkit

Cursor— Cursor Marketplace에서 설치하세요 ( "AgenticFlow" 검색).

Gemini CLI— 실행하세요: gemini extensions install https://github.com/PixelML/agenticflow-skill

OpenAI Codex CLI— Codex에서 /plugins를 실행하고, AgenticFlow를 검색한 뒤 Add to Codex를 선택하세요.

VS Code / 기타— 명령 팔레트(Command Palette)를 열고 Chat: Install Plugin From Source를 실행한 다음, 다음을 붙여넣으세요: https://github.com/PixelML/agenticflow-skill

스킬(skills)은 af CLI가 설치되어 있다고 가정합니다:

# 빠른 시도 (설치 없음)
npx @pixelml/agenticflow-cli bootstrap --json
# 전역 설치 (일상적인 사용을 위해 권장됨)
...

Node.js 18+ 버전이 필요합니다.

API 키를 받으세요. app.agenticflow.ai 에 로그인하여 Settings → API Keys → Create key로 이동하세요. a9w_... 토큰을 복사하세요.

CLI를 연결하세요. af login을 실행하거나(대화형 — API 키, 워크스페이스 ID, 프로젝트 ID를 요청하며 ~/.agenticflow/auth.json에 저장됨), 셸(shell)에서 환경 변수(env vars)를 내보내세요(export): CI/CD의 경우 환경 변수를 사용하세요; export AGENTICFLOW_API_KEY=a9w_xxxxx export AGENTICFLOW_WORKSPACE_ID=<your-workspace-uuid> export AGENTICFLOW_PROJECT_ID=<your-project-ulid> 개발용 머신에는 af login을 사용하세요.

검증하세요. af doctor --json --strict를 실행하세요 — health: true와 함께 종료 코드 0으로 종료되어야 합니다. 만약 실패한다면, 에러 엔벨로프(error envelope)의 hint가 무엇을 수정해야 하는지 정확히 알려줄 것입니다.

파악하세요. af bootstrap --json을 실행하세요 — 이것은 항상 모든 세션의 첫 번째 명령입니다. 이 명령은 한 번의 호출로 인증(auth), 에이전트(agents), 워크포스(workforces), 블루프린트(blueprints), 플레이북(playbooks), 그리고 명령 치트 시트(commands cheat-sheet)를 반환합니다.

프롬프트(prompt)에 따라 세 가지 주요 스킬이 자동으로 라우팅됩니다:

스킬 (Skill)	실행 조건 (When it fires)	포함 내용 (What it covers)
agenticflow-workforce	"team", "multi-agent", "pipeline", 블루프린트 이름 (dev-shop, marketing-agency, amazon-seller, …)	af workforce * , 블루프린트 결정 (blueprint decisions), 그래프 와이어링 (graph wiring), 게시(publish) + 공개 URL
agenticflow-agent	"create/build an agent", "support bot", "customer assistant", "system prompt"	af agent * , --patch 반복 패턴 (iteration pattern), 스키마 드릴다운 (schema drilldown)
agenticflow-mcp	"mcp", "attach tools", 프로바이더 이름 (google sheets/docs, notion, slack, gmail 등)	af mcp-clients inspect/list/get , Pipedream 대 Composio의 쓰기 안전성 (write-safety), 부착 형태 (attach shape)

긴 형식의 참조 자료는 reference/에 유지됩니다.

— CLI 설정, 비즈니스 팩, 문제 해결 (troubleshooting), 용어 사전 (glossary).

새로운 기능이 CLI에 도입됨에 따라 플러그인 (Plugins)은 자동으로 업데이트됩니다. 주요 인터페이스 변경 사항(예: v1.6에서의 workforce 배포)은 플러그인이 새로고침되면 스킬 (skills)에 전파됩니다.

사용 중인 플랫폼이 플러그인을 지원하지 않는 경우, 이 리포지토리 (repo)에서 스킬을 직접 설치하거나 af CLI 스탠드얼론 (standalone) 버전을 사용하십시오:

• 스킬 (Skills) (모놀리식 레거시 복사본) — 단일 파일, 여전히 작동함
• CLI 참조 라이브러리 (CLI Reference Library) — 모든 LLM에서 사용 가능한 마크다운 (markdown) 페이지

스탠드얼론 MCP 서버 (standalone MCP server) (agenticflow-mcp 리포지토리)는 CLI보다 기능이 크게 뒤처지므로 권장하지 않습니다. 대신 af CLI (npm install -g @pixelml/agenticflow-cli를 통해 설치)를 사용하십시오.

외부 풀 리퀘스트 (pull requests)는 받지 않습니다. 모든 풀 리퀘스트는 자동으로 종료됩니다.

PixelML 직원: 이 미러 (mirror) 리포지토리가 아닌 업스트림 소스 리포지토리 (upstream source repository)를 대상으로 풀 리퀘스트를 생성하십시오.

MIT