Agent skill

Agent Platform API

by HuangPuStar in HuangPuStar/FenixAgent

RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。

Apache-2.0Auto-check: notesBackend & APIs

Install Agent Platform API

skills CLI
$ npx skills add HuangPuStar/FenixAgent --skill agent-platform-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HuangPuStar/FenixAgent agent-platform-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HuangPuStar/FenixAgent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-platform-api .claude/skills/agent-platform-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agent-platform-api
GitHub stars
552
Token cost
~565 tokens
SKILL.md length
150 words
Files
10 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。

  • Tasks that involve REST APIs
  • SKILL.md covers 认证, 响应格式, API 模块索引 and 常用 jq 技巧
  • Calls jq and curl; needs USER_META_API_KEY

What it does

Agent Platform API is an agent skill from HuangPuStar/FenixAgent. RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `references/agent-sites.md`, `references/card-tag.md` and `references/config.md`).

It sits in Backend & APIs, covering REST APIs. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve REST APIs

Example prompts

  • “/agent-platform-api”

Requirements

  • Docker
  • A credential in USER_META_API_KEY
  • Pre-approved tools (allowed-tools): Bash

What it can do on your machine

Read from SKILL.md and the folder at commit da5eb54. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • USER_META_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Platform API loads about 565 tokens when it runs, and up to ~27k if it reads all its reference files. Until then it costs about 25 tokens; SKILL.md has 150 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~565
With references · SKILL.md plus every file in references/, read only if the agent opens them
~27k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HuangPuStar/FenixAgent at commit da5eb54, republished under its Apache-2.0 licence (© HuangPuStar). 150 words, ~565 tokens.

Download SKILL.mdSave it as .claude/skills/agent-platform-api/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
agent-platform-api
description
RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。
allowed-tools
Bash

RCS Platform API

认证

以下环境变量由系统自动注入:

  • $USER_META_BASE_URL — API 服务器地址(仅限 agent 内部调用 RCS API 使用)

$USER_META_BASE_URL 是服务器内部地址,与用户通过浏览器访问的外部地址不同。 该变量只用于 curl 调用 RCS 后端 API(如 curl $USER_META_BASE_URL/web/...),禁止直接拼接后展示给用户。建站等需要告知用户访问地址的场景,统一通过 <agent-sites> 卡片标签或引导用户操作 UI tab 来提供入口,不要手工拼接和暴露 URL。

  • $USER_META_API_KEY — Bearer token,所有请求必须携带
  • $USER_META_USER_ID — 当前请求用户 ID,用于标注资源归属或调用 user-scoped API
  • $USER_META_ORG_ID — 当前组织 ID,多租户隔离/调用 organization-scoped API 时使用

沙盒网络例外:先使用注入的 $USER_META_BASE_URL。只有当其主机为 localhost / 127.0.0.1 且在当前沙盒中连接失败时,才在当前 shell 将主机替换为 host.docker.internal 后重试;保留原协议、端口和路径。该替换后的内部地址同样不得向用户展示。

所有请求必须携带 Authorization 头:

bash
AUTH="-H 'Authorization: Bearer $USER_META_API_KEY' -H 'Content-Type: application/json'"

关于组织隔离:绝大多数 /web/* 路由后端会从 API Key 元数据自动取 $USER_META_ORG_ID 作为隔离范围,无需在 URL query 或 body 中显式传 organizationId。$USER_META_ORG_ID / $USER_META_USER_ID 仅在少数需要明确指定目标组织/用户的接口(如 /web/organizations 的 action 类操作)中作为 body 字段传入。

响应格式

成功响应通常为:{ "success": true, "data": ... }。

失败响应尚未全局统一:路由主动返回的业务错误通常是 { "success": false, "error": { "code": "ERROR_CODE", "message": "..." } };全局错误处理、限流等也可能是 { "error": { "type": "ERROR_CODE", "message": "..." } },没有 success 字段。调用方必须先判断 HTTP 状态码,再兼容读取 error.code 和 error.type;不要把其中任一形状当作所有 /web/* 接口的保证。

API 模块索引

模块文档说明
环境references/environment.md环境创建/列表/进入/实例管理
工作流references/workflow.md工作流定义/执行引擎/触发器
配置references/config.mdProvider/Model/Agent/Skill/MCP 配置
任务references/task.md定时任务 CRUD/触发/日志
知识库references/knowledge.md知识库 CRUD/文件上传
组织references/org.md当前不可用;禁止调用组织、成员和 API Key 接口
Agent Sitesreferences/agent-sites.md建站部署/App 管理/PocketBase 后端配置/前端上传

使用某个模块的 API 前,先 cat references/<module>.md 读取完整文档和 curl 示例。

常用 jq 技巧

bash
| jq '.data'                  # 提取 data 字段
| jq '.data[] | { id, name }' # 列表提取 id 和 name
| jq -r '.data.draftYaml'     # 原文输出工作流草稿
| jq '{ success }'            # 只看成功状态

© HuangPuStar, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in .agents/skills/agent-platform-api of HuangPuStar/FenixAgent.

  • SKILL.md
  • references/agent-sites.md
  • references/card-tag.md
  • references/config.md
  • references/environment.md
  • references/html-guide.md
  • references/knowledge.md
  • references/org.md
  • references/task.md
  • references/workflow.md

Open the folder on GitHubat commit da5eb54

Compare with similar skills

Agent Platform API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Platform API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Platform API this skillHuangPuStar/FenixAgent552—~565Automated safety check: NotesApache-2.0
API DesignerJeffallan/claude-skills12k2 repos~2kAutomated safety check: PassMIT
Paperclippaperclipai/paperclip98k—~9.6kAutomated safety check: PassMIT
Nodejs Backend Patternsever-works/ever-works15817 repos~4kAutomated safety check: PassAGPL-3.0
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT

Similar skills

  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    98k GitHub stars~9.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    158 GitHub starsUsed in 17 repos~4k tokens
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Covers the RuView `wifi-densepose` command line binary, its Axum REST API and the WebAssembly builds for browsers and ESP32, for embedding or scripting RuView.

    97k GitHub stars~1.2k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

More from HuangPuStar/FenixAgent

  • Auto Devflow

    HuangPuStar/FenixAgent

    A skill your agent uses when starting an issue, bugfix, feature, or refactor that should be driven by multiple coordinated subagents: explore → plan → code → review, with the main agent acting as…

    552 GitHub stars~3k tokensUpdated 7 days ago
    Auto-check passed
  • Zentao Manager

    HuangPuStar/FenixAgent

    通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

    552 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Fenix Code Review

    HuangPuStar/FenixAgent

    执行 FenixAgent 项目专用代码审查。手动触发,默认审查已暂存改动,或按用户提供的文件路径、提交范围、分支 diff 范围进行审查,并生成审查报告。

    552 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Show HTML Or Picture

    HuangPuStar/FenixAgent

    当需要把本地 HTML 或图片文件展示给前端时使用。优先引用当前工作目录下的 user/ 目录中的文件;如果文件在其他位置,先复制到当前工作目录的 user/ 再展示。路径由前端自动改写为 /fs/ 路由代理,Agent 只需输出 user/ 相对路径即可。最终只输出可直接渲染的相对路径片段:HTML 输出 iframe,图片输出 Markdown 图片;路径不能是绝对路径,也不能以 /…

    552 GitHub stars~475 tokensUpdated 7 days ago
    Auto-check passed
  • Skill Creator

    HuangPuStar/FenixAgent

    帮助用户创建、编辑和优化 Agent Skill 指令文件。当用户提到"创建 skill"、"写技能"、"编辑 skill"、"优化技能"、"新建技能"或需要生成 SKILL.md 文件时使用。

    552 GitHub stars~469 tokensUpdated 7 days ago
    Auto-check passed

Categories

Questions about Agent Platform API

What does Agent Platform API do?

RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。. Agent Platform API is an agent skill from HuangPuStar/FenixAgent.

When should I use Agent Platform API?

Agent Platform API fits situations like: tasks that involve REST APIs.

How do I install Agent Platform API in Claude Code?

Run `npx skills add HuangPuStar/FenixAgent --skill agent-platform-api -a claude-code`. Or copy the skill folder (.agents/skills/agent-platform-api in HuangPuStar/FenixAgent) into .claude/skills/agent-platform-api in your project. Claude Code loads it when a task matches its description.

How do I install Agent Platform API in Codex?

Run `npx skills add HuangPuStar/FenixAgent --skill agent-platform-api -a codex`. Or copy the skill folder (.agents/skills/agent-platform-api in HuangPuStar/FenixAgent) into .agents/skills/agent-platform-api in your project. Codex loads it when a task matches its description.

Can I use Agent Platform API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HuangPuStar/FenixAgent --skill agent-platform-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-platform-api, .gemini/skills/agent-platform-api, .github/skills/agent-platform-api and .opencode/skills/agent-platform-api in your project.

What does Agent Platform API need to run?

Going by SKILL.md and its folder, Agent Platform API needs the command-line tools its instructions call (jq and curl) and credentials named USER_META_API_KEY. Our summary lists: Docker; A credential in USER_META_API_KEY. Its frontmatter pre-approves these tools: Bash.

Does Agent Platform API access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Agent Platform API safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Agent Platform API use?

Agent Platform API is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Platform API use?

About 565 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 27k tokens, read only when the agent opens those files.

What are the alternatives to Agent Platform API?

Skills that share tags, products or a category with Agent Platform API: API Designer (Jeffallan/claude-skills, 12k stars), Paperclip (paperclipai/paperclip, 98k stars), Nodejs Backend Patterns (ever-works/ever-works, 158 stars) and OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Platform API?

HuangPuStar (a GitHub organization) maintains it in HuangPuStar/FenixAgent, which has 552 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on September 30, 2026.

Source: HuangPuStar/FenixAgent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.