Vì sao agents/ chỉ có openai.yaml?

Tên thư mục agents dễ gây hiểu nhầm rằng mỗi file là một sub-agent. Trong cấu trúc skill của OpenAI, agents/openai.yaml là optional host metadata: OpenAI dùng nó để cấu hình appearance, invocation policy và tool dependencies. Nó không tạo ra một agent tên OpenAI và cũng không chứa reasoning loop.

Package chỉ có openai.yaml vì tác giả mới khai báo integration mà OpenAI đã document. Không có yêu cầu phải tạo đủ claude.yaml, antigravity.yaml hay autogen.yaml. Quan trọng hơn, không nên tự chế các filename đó chỉ để cây thư mục trông đối xứng; mỗi host có format và vị trí config riêng.

Portable core gồm SKILL.md với name, description và instruction, kèm scripts, references hoặc assets nếu cần. Đây là phần chứa workflow mà một host hỗ trợ Agent Skills có thể khám phá và thực hiện.

Host adapter chỉ cải thiện trải nghiệm trên một runtime cụ thể. Với OpenAI, interface định nghĩa display_name, short_description, icon, brand color và default prompt; policy điều khiển implicit invocation; dependencies khai báo tool mà host nên chuẩn bị. Nếu xóa openai.yaml, skill có thể mất icon hoặc integration tiện lợi nhưng logic trong SKILL.md không nên biến mất.

Một host không triển khai extension của OpenAI không có lý do để diễn giải file này. Nó có thể bỏ qua file và chỉ dùng SKILL.md. Khả năng portable vì vậy phụ thuộc vào việc workflow cốt lõi không tham chiếu ngược vào behavior chỉ OpenAI mới hiểu.

Nếu muốn tối ưu cho host thứ hai, trước hết phải đọc tài liệu chính thức của host đó: nó có dùng cùng Agent Skills spec không, có manifest riêng không, file nằm ở đâu và field nào được hỗ trợ. Portability là common denominator có chủ ý, không phải đổi chữ openai thành tên vendor.

interface là presentation layer. Nó giúp người dùng nhận ra skill và khởi động bằng prompt phù hợp, nhưng một icon đẹp không cải thiện execution correctness. policy.allow_implicit_invocation là routing control: false ngăn Codex tự chọn skill theo prompt, trong khi explicit invocation vẫn hoạt động.

dependencies.tools là dependency declaration, không phải quyền truy cập. Nó mô tả tool integration cần cho trải nghiệm trơn tru; quyền thực tế vẫn do runtime, workspace, authentication và approval quyết định. Khai báo MCP URL không tự đăng nhập và không tự vượt sandbox.

Hãy thử nghiệm bằng cách tạm bỏ agents/openai.yaml. Nếu skill không còn biết workflow, input, output hoặc done-condition, boundary đã sai. Nếu chỉ mất display name, icon, implicit routing preference hoặc dependency hint, boundary đang hợp lý.