$npx -y skills add QwenCloud/qwencloud-ai --skill qwencloud-text[QwenCloud] Generate text, have conversations, write code, reason, and call functions with Qwen models. TRIGGER when: user asks to chat with Qwen, generate text, write code with Qwen, use Qwen function calling, or explicitly invokes this skill by name (e.g. use qwencloud-text). D
| 1 | > **Agent setup**: If your agent doesn't auto-load skills (e.g. Claude Code), |
| 2 | > see [agent-compatibility.md](references/agent-compatibility.md) once per session. |
| 3 | |
| 4 | # Qwen Text Chat (OpenAI-Compatible) |
| 5 | |
| 6 | Generate text, conduct conversations, write code, and invoke tools using Qwen models through the OpenAI-compatible API. |
| 7 | This skill is part of **qwencloud/qwencloud-ai**. |
| 8 | |
| 9 | ## Skill directory |
| 10 | |
| 11 | Use this skill's internal files to execute and learn. Load reference files on demand when the default path fails or you |
| 12 | need details. |
| 13 | |
| 14 | | Location | Purpose | |
| 15 | |-------------------------------------|-------------------------------------------------------------------------------------| |
| 16 | | `scripts/text.py` | Default execution — chat/completions request, streaming, output save | |
| 17 | | `references/execution-guide.md` | Fallback: curl, Python SDK, function calling, thinking mode | |
| 18 | | `references/api-guide.md` | API supplement and full code examples | |
| 19 | | `references/prompt-guide.md` | Prompt engineering: CO-STAR framework, CoT, few-shot, task steps | |
| 20 | | `references/sources.md` | Official documentation URLs (manual lookup only) | |
| 21 | | `references/agent-compatibility.md` | Agent self-check: register skills in project config for agents that don't auto-load | |
| 22 | |
| 23 | ## Security |
| 24 | |
| 25 | **NEVER output any API key or credential in plaintext.** Always use variable references (`$DASHSCOPE_API_KEY` in shell, |
| 26 | `os.environ["DASHSCOPE_API_KEY"]` in Python). Any check or detection of credentials must be **non-plaintext**: report |
| 27 | only status (e.g. "set" / "not set", "valid" / "invalid"), never the value. Never display contents of `.env` or config |
| 28 | files that may contain secrets. |
| 29 | |
| 30 | **When the API key is not configured, NEVER ask the user to provide it directly.** Instead, help create a `.env` file with a placeholder (`DASHSCOPE_API_KEY=sk-your-key-here`) and instruct the user to replace it with their actual key from the [QwenCloud Console](https://home.qwencloud.com/api-keys). Only write the actual key value if the user explicitly requests it. |
| 31 | |
| 32 | ## Key Compatibility |
| 33 | |
| 34 | Scripts require a **standard QwenCloud API key** (`sk-...`). Coding Plan keys (`sk-sp-...`) cannot be used for direct |
| 35 | API calls — they are designed exclusively for interactive coding tools (Cursor, Claude Code, Qwen Code) and do not work |
| 36 | on QwenCloud API endpoints. The script detects `sk-sp-` keys at startup and prints a warning. If qwencloud-ops-auth is installed, |
| 37 | see its `references/codingplan.md` for details on key types, endpoint mapping, and error codes. |
| 38 | |
| 39 | ## Model Selection |
| 40 | |
| 41 | | Model | Use Case | |
| 42 | |--------------------|-------------------------------------------------------------------------| |
| 43 | | `qwen3.6-plus` | **Recommended default** — latest flagship, balanced performance/cost/speed, 1M context, thinking on by default, multimodal (text+image+video) | |
| 44 | | `qwen3.5-plus` | Balanced performance, cost, speed, 1M context, thinking on by default | |
| 45 | | `qwen3.5-flash` | Fast, low-cost, 1M context | |
| 46 | | `qwen3-max` | Strongest capability, built-in tools (web search, code interpreter) | |
| 47 | | `qwen-plus` | General purpose | |
| 48 | | `qwen-turbo` | Cheapest, low latency | |
| 49 | | `qwen3-coder-next` | **Recommended code model** — best balance of quality, speed, cost; agentic coding | |
| 50 | | `qwen3-coder-plus` | Code generation — highest quality for complex tasks | |
| 51 | | `qwen3-coder-flash`| Code generation — fast responses, lower cost | |
| 52 | | `qwq-plus` | Reasoning / chain-of-thought | |
| 53 | | `qwen-mt-plus` | Machine translation — best quality, 92 languages | |
| 54 | | `qwen-mt-flash` | Machine translation — fast, low cost, 92 languages | |
| 55 | | `qwen-mt-lite` | Machine translation — real-time chat, fastest, 31 languages | |
| 56 | | `qwen-pl |