Poyo Claude Sonnet 5

SKILL.md

---
name: poyo-claude-sonnet-5
description: Claude Sonnet 5 chat on PoYo / poyo.ai via `https://api.poyo.ai/v1/messages`; use for `claude-sonnet-5`, Claude-compatible messages, coding agents, long-context chat, system prompts, tool use, structured output, prompt cache settings, vision content blocks, streaming, and server-side integration.
metadata: {"openclaw":{"homepage":"https://docs.poyo.ai/api-manual/chat-series/claude-messages","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}
---

# PoYo Claude Sonnet 5 Messages

Use this skill for Claude Sonnet 5 requests on PoYo. It helps agents prepare Claude-compatible Messages API payloads, streaming calls, tool definitions, structured output settings, and server-side integration notes.

## Use When

- The user mentions Claude Sonnet 5, `claude-sonnet-5`, Claude Messages API, Claude-compatible messages, Claude tool use, or Claude structured output.
- The task is coding assistance, agent planning, long-form analysis, document summarization, multi-turn chat, tool planning, or vision prompt construction.
- The workflow needs a server-side curl example or a production Messages API payload for PoYo.

## Model Selection

- `claude-sonnet-5`: use for Claude Sonnet 5 Messages API requests on PoYo.

## Key Inputs

- `model` is required and should be `claude-sonnet-5` for this skill.
- `messages` is required and should contain `role` and `content`.
- `max_tokens` controls response length.
- `system` sets assistant behavior and can be a string or supported content blocks.
- `tools` and `tool_choice` configure tool use when the application can execute tools.
- `output_config` can request structured output when supported.
- `cache_control` can mark reusable prompt content when supported.
- `stream: true` requires streaming-aware client handling.

## Security Rules

- Treat `POYO_API_KEY` as a secret.
- Keep PoYo API keys in server-side environment variables or a backend secret manager.
- Never place an API key in browser code, frontend bundles, public repositories, logs, screenshots, or chat output.
- Do not log private user messages, system prompts, image content, tool inputs, or raw API key headers unless the user or product policy explicitly allows it.
- Do not make live API calls unless the user explicitly asks and provides a safe server-side environment.

## Execution

- Read `references/api.md` for endpoint details, request fields, examples, and response notes.
- Use `scripts/submit_claude_sonnet_5_messages.sh` only when the user wants to submit a prepared JSON payload from a trusted shell.
- If the user only needs a curl example, adapt one from `references/api.md`.
- Claude Messages calls are synchronous unless streaming is enabled.

## Output Expectations

When helping with Claude Sonnet 5, include:

- chosen model id
- final payload or concise parameter summary
- synchronous or streaming handling
- system prompt, tools, structured output, and cache settings when relevant
- response parsing notes if the user needs integration code