About

Imported from akillness/jeo-skills (.agent-skills/openai-agents-python/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill openai-agents-python. Copyright stays with the author.

OpenAI Agents Python

Name: openai-agents-python
Author: akillness

When to use this skill

OpenAI Agents SDK 기반으로 멀티에이전트 워크플로우를 만들 때
tool calling, handoff, guardrail이 필요한 에이전트 설계를 할 때
프로토타입이 아니라 운영 가능한 에이전트 루프 구조가 필요할 때

Instructions

Step 1) 작업 목표를 에이전트 토폴로지로 분해

Coordinator 1개 + Specialist N개 기본 구조로 시작
각 Specialist는 단일 책임(검색/분석/실행/검증) 원칙 유지
handoff 조건을 자연어가 아니라 명시 규칙으로 기록

Step 2) 최소 실행 루프 먼저 만들기

첫 단계는 “한 입력 → 한 handoff → 한 결과”의 최소 루프
도구 호출 실패/타임아웃을 표준 에러 포맷으로 수집
로그는 agent, tool, handoff, latency 기준으로 남김

Step 3) Guardrail 추가

금지 작업(파괴적 명령, 외부 전송)을 정책으로 명시
출력 스키마를 고정(JSON schema)해 후속 파이프라인 안정화
재시도 횟수/중단 조건(max turns) 명시

Step 4) 품질 점검

케이스 3종: 정상, 경계, 실패
handoff 오탐/미탐 비율을 체크
에러가 반복되면 프롬프트보다 라우팅 규칙을 먼저 수정

Examples

요청: "리서치/요약/검증을 분리한 에이전트 파이프라인을 만들고 싶다"
적용: Coordinator가 intent 분류 후 Researcher/Writer/Verifier로 handoff
결과: 단계별 산출물과 검증 로그를 분리 저장

Best practices

처음부터 5개 이상 에이전트로 시작하지 않는다.
handoff 규칙은 문장보다 조건식으로 기록한다.
모델 교체 가능성을 위해 도구 인터페이스를 고정한다.
실패 복구는 재시도보다 fallback route(다른 specialist)로 푼다.

References

https://github.com/openai/openai-agents-python

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-openai-agents-python/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-openai-agents-python.ocm.jsonjson

{
  "ocm": "1",
  "id": "akillness-jeo-skills-openai-agents-python",
  "kind": "skill",
  "name": "openai-agents-python",
  "description": "Build and operate multi-agent workflows with OpenAI Agents SDK (Python): define agents/tools/handoffs, add guardrails, run conversations, and debug orchestration behavior. Use when users ask for agent orchestration with OpenAI-native patterns, handoff routing, or production-ready agent loops.",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "agentic-ai",
      "multi-agent",
      "orchestration",
      "openai",
      "python",
      "handoff",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Build and operate multi-agent workflows with OpenAI Agents SDK (Python): define agents/tools/handoffs, add guardrails, run conversations, and debug orchestration behavior. Use when users ask for agent orchestration with OpenAI-native patterns, handoff routing, or production-ready agent loops."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/openai-agents-python/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/openai-agents-python/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/openai-agents-python/SKILL.md"
    },
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Edit",
      "Grep",
      "Glob"
    ]
  },
  "instructions": "# OpenAI Agents Python\n\n## When to use this skill\n- OpenAI Agents SDK 기반으로 멀티에이전트 워크플로우를 만들 때\n- `tool calling`, `handoff`, `guardrail`이 필요한 에이전트 설계를 할 때\n- 프로토타입이 아니라 운영 가능한 에이전트 루프 구조가 필요할 때\n\n## Instructions\n\n### Step 1) 작업 목표를 에이전트 토폴로지로 분해\n- Coordinator 1개 + Specialist N개 기본 구조로 시작\n- 각 Specialist는 단일 책임(검색/분석/실행/검증) 원칙 유지\n- handoff 조건을 자연어가 아니라 명시 규칙으로 기록\n\n### Step 2) 최소 실행 루프 먼저 만들기\n- 첫 단계는 “한 입력 → 한 handoff → 한 결과”의 최소 루프\n- 도구 호출 실패/타임아웃을 표준 에러 포맷으로 수집\n- 로그는 `agent`, `tool`, `handoff`, `latency` 기준으로 남김\n\n### Step 3) Guardrail 추가\n- 금지 작업(파괴적 명령, 외부 전송)을 정책으로 명시\n- 출력 스키마를 고정(JSON schema)해 후속",
  "cost": {
    "context_tokens": 278
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-openai-agents-python/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.