SkillFoxx

Agnes-help-skill

Agnes AI support skill: API onboarding, fixing 401–503 errors, choosing text, image and video models, setting up Codex

  • 315 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • On every load the skill contacts GitHub to check its version.
  • The skill works with an Agnes API key stored in client settings.
All reasons and checks

lj1270998580-crypto/agnes-help-skillAuthor:lj1270998580-crypto

Install

Manual install

Text for your agent

请读取并安装 Agnes AI 支持 Skill：https://github.com/lj1270998580-crypto/Agnes-help-skill

The agent phrase from the README: the agent reads the repository and installs the skill the native way.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • On every load the skill contacts GitHub to check its version.
  • The skill works with an Agnes API key stored in client settings.

This is third-party code. Review the repository files before installing.

What it does

The skill helps connect the Agnes AI API for text, images and video. The agent walks a newcomer through getting a key and picking a base URL, diagnoses 401, 400, 429, 500 and 503 errors, and explains how to enable Thinking mode, streaming and tool calling. There are separate hints for long video queues and failed image generation. The repository holds `SKILL.md` and `agnes-ai-api-documentation.md` with model parameters, RPM limits and the Token Plan, which the skill relies on when answering. On every load it compares its version with the latest GitHub commit and warns about an update. The repository is unofficial and does not belong to Agnes AI.

Who it is for. Developers who connect Agnes AI models to Codex, Claude Code, OpenClaw, Hermes and similar clients.

Good fit when

  • The Agnes API returns a 401 or 429 error and it is unclear what to fix.
  • You need to choose between `agnes-3.0-flash` and the paid Pro series models.
  • A video sits in the queue for too long and image generation fails.
  • Codex or OpenClaw must be pointed at the Agnes base URL.

Not a fit when

  • Official support is needed, and bug reports go to the Agnes AI Labs team in its own repository.
  • Agnes models are not used, and the skill has nothing on other providers.
  • The skill must not contact GitHub to check for updates.

Example request

My request to `agnes-3.0-flash` returns 401. Work out what is wrong with the key and the base URL.

Limitations

The skill is unofficial: model, limit and pricing details were taken from the Agnes documentation as of September 2026 and may go stale, including the RPM limit for free models cut to 10 requests per minute. You need your own Agnes API key. On every load the skill contacts GitHub for the latest commit. Documentation is mostly in Chinese. The free status of Flash models was stated in the README at update time and may change, so check prices on the Agnes platform.

How to disable. Delete the `agnes-ai-support` skill folder from the agent skills directory. Revoke any Agnes API key saved in client settings separately on the Agnes platform.

FAQ

How do I install the skill?

Send the agent the phrase "请读取并安装 Agnes AI 支持 Skill" with the repository link. Or place `SKILL.md` into the agent skills directory by hand.

Which Agnes models are covered?

Text `agnes-3.0-flash` and `agnes-2.5-flash`, paid `agnes-2.5-pro`, images `agnes-image-2.5-flash`, video `agnes-video-2.5-flash` and the paid `agnes-video-2.5`.

Which base URL should I use?

`https://apihub.agnes-ai.com/v1` for international access or `https://apihub.agnes-ai.cn/v1` for mainland China, with an `Authorization: Bearer` header and your key.

Is the skill official?

No. It is an unofficial help collection; the official bug repository belongs to Agnes AI Labs.

What does the skill do on load?

It compares its version with the latest repository commit on GitHub and, if a newer one exists, warns at the start of the reply.

Discussion

No questions or reviews yet.

Skills

A catalog of nearly two hundred skills: code delivery, review, debugging, AI governance, product work and agent coordination.

SkillMinimal access175

A CLI and Python SDK to search, install, create and evaluate reusable agent skills from a shared library

CLIExtended access1.5K

A CLI skill manager for AI agents: install from repositories, translate between agent formats and deploy into their configs

CLIExtended access1.6K

The `askit` command line toolkit for agent skills: lint, security scan, tests, forging new ones and export to any agent.

CLIExtended access50

90 specialist skills and the Nexus orchestrator for Claude Code, Codex and Antigravity: bugs, tests, security, review, UX

SkillExtended access99

A skill registry with a CLI and API: the agent describes a task and gets a recommendation with a trust score and install command

CLIExtended access371

README in short

The repository gathers the Agnes AI API documentation and a supporting skill for different clients. The skill tracks its own version separately and suggests diagnostics for typical errors.

README badge

Original SKILL.md

---
name: agnes-ai-support
version: "1.3.2"
description: |
  Agnes AI API 接入支持与问题排查 Skill。帮助新用户完成 Agnes AI API 的接入配置，
  诊断和解决接入过程中遇到的认证、参数、响应、图像生成、视频生成等各类问题。
  涵盖 Thinking 模式开启、视频长度调节、流式输出、工具调用等高级功能指导。
  兼容 OpenClaw、Claude Code、Hermes、Codex 等工具链。
>  触发词：Agnes AI、agnes、接入、API Key、401、400、排查、错误、视频生成、图像生成、
  thinking、stream、tool calling、模型选择、Base URL、响应格式、timeout、超时、轮询、
  FAQ、问题排查、调试、免费调用、RPM、video_id、task_id、Prompt 模板、提示词、
  生图、生视频、图生图、文生图、图生视频、文生视频、灰度自检、1M 上下文、4K 图片、4K 图、4K、灰度、自检、反馈、Bug、issue、问题反馈、功能建议。
---

# Agnes AI API 接入支持与问题排查

> **Skill 版本：** v1.3.2
> **适用工具：** OpenClaw / Claude Code / Claude Desktop / Hermes / Codex / WorkBuddy / Cherry Studio / Opencode / Kimi Work
> **更新日期：** 2026-09-23
> **官方 Bug 反馈：** https://github.com/AgnesAI-Labs/Agnes-AI/issues
> **官方进度看板：** https://github.com/users/AgnesAI-Labs/projects/1
> **官方 Bug 反馈：** https://github.com/AgnesAI-Labs/Agnes-AI/issues
> **官方进度看板：** https://github.com/users/AgnesAI-Labs/projects/1
> **GitHub 仓库：** https://github.com/lj1270998580-crypto/Agnes-help-skill
> **官方平台：** https://platform.agnes-ai.com
> **官方文档：** https://agnes-ai.com/doc/overview
> **操作手册：** https://agnes-ai.com/doc/%E5%B8%B8%E7%94%A8%E6%8E%A5%E5%85%A5%E6%96%87%E6%A1%A3
> **社区教程：** https://github.com/Yacey/agnes-ai-generation-skill
> **社区 Skill：** https://github.com/kangarooking/agnes-free-model-skills
> **ComfyUI 节点：** https://github.com/16nic/comfyui-agnes-ai
> **常见问题 QA（飞书）：** https://icn1d2hdv39m.feishu.cn/wiki/R7TEwjadJibD62kWeS9cubtpnPi

---

## 版本检查与更新提醒

**每次加载本 Skill 时，请执行以下检查：**

### 步骤 1：检测版本

1. 读取 GitHub 仓库最新 commit 信息：
   ```
   https://api.github.com/repos/lj1270998580-crypto/Agnes-help-skill/commits?per_page=1
   ```

2. 比较远程最新 commit 的 `sha` 与本地记录的版本（`v1.2.11` 对应 `sha: `）。

3. 如果 `sha` 不匹配 → 说明有新版本，继续步骤 2。

### 步骤 2：读取更新内容（重要）

Report a problem