Skip to content

Skills

What your AI can do, packaged.

Open Skills
Checked against the dashboard on November 20, 2026

The public API has seven methods for skills. The API still calls a skill an AI agent, so that is the name in every method. They act on skills that already exist: they pin one, mark one as a favorite, archive one, make it a picture, and record a consent. Each acts for the account whose API key you use.

Making a skill, planning one from your words, changing its instructions or tools, cloning, installing from the marketplace, listing, sharing, unarchiving, deleting and choosing a plan are done in the dashboard. They have no public method today.

Send a request to a method with your key:

curl -s https://xuda.ai/cpi/pin_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_SKILL_ID"}'
const res = await fetch('https://xuda.ai/cpi/pin_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', agent_id: 'YOUR_SKILL_ID' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/pin_ai_agent',
    json={'api_key': 'YOUR_API_KEY', 'agent_id': 'YOUR_SKILL_ID'},
)

A good answer has code 1. A refused one has a negative code and says why in data.

Every method takes the skill's id as agent_id, which is the last part of the skill's address in the dashboard. Except set_agent_tool_consent, each also takes an optional workspace_id, to act in a workspace other than your own home one. You must own that workspace.

Pin and mark as a favorite

Archive

archive_ai_agent moves a skill out of the active list and into Archived. An archived skill no longer counts toward the number the workspace's plan holds, which makes this a way to make room under a limit.

  • Only the person who made the skill can archive it. For anyone else the answer is a refusal that says the operation is not allowed.
  • A skill you have shared with others is refused while that share is active. End the share first.
  • conversation_id is optional. With it, only that one conversation of the skill is archived. Without it, all of the skill's conversations are archived with it.

Bringing a skill back, or deleting it for good, is done in the dashboard, from the Archived view.

Make a picture

generate_ai_agent_image makes a new picture for one skill you own and saves it on the skill. Use it when a skill has no picture and its card falls back to the placeholder. It runs in the background, so the new picture appears the next time the skill is loaded. It is the same thing as Generate image in the card's menu.

Allow an installed skill to use its publisher's tools

set_agent_tool_consent records whether you allow an installed skill to use plugin tools that run in its publisher's workspace. Anything those tools create is stored in the publisher's drive rather than yours. It takes agent_id and granted, true to allow and false to withdraw, and optionally owner_uid, the publisher's account. It only ever records your own decision, never somebody else's.

A skill's count and its plan

Skills are counted by the plan of the workspace they are in. See Plans and billing for what counts and what happens at the limit.

How is this guide?

Last updated on November 15, 2026