iblai-api-agent-skill

iblai-api-agent-skill

Manage an agent's skills via the API: browse the org's skill catalog, toggle which skills an agent has assigned, and manage the catalog itself (create / edit / delete reusable skills). Use when giving an agent reusable skill instructions.

Auth & conventions

• Base URL: https://api.iblai.app
• Header: Authorization: Api-Token $IBLAI_API_KEY on every request.
• Path vars: {org} = $IBLAI_ORG, {username} = $IBLAI_USERNAME, {mentor} = the agent's unique id (e.g. d17dc729-60fd-4363-81a0-f67d9318b03e).
• Not connected yet? Run /iblai-api-login first to populate IBLAI_ORG, IBLAI_USERNAME, and IBLAI_API_KEY.

Reads

• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/mentors/{mentor}/claw-config/ — gate (skills require a sandbox).
• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/agent-skills/ — platform skill catalog.
• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/mentors/{mentor}/skills/ — skills assigned to this agent.

Writes

Assignment (toggle)

• POST …/mentors/{mentor}/skills/ — assign a skill to the agent:

  {
    "skill": "uuid (required)",
    "enabled": "boolean"
  }
  

• PATCH …/mentors/{mentor}/skills/{assignmentId}/ — enable / disable an assignment:

  {
    "enabled": "boolean"
  }
  

• DELETE …/mentors/{mentor}/skills/{assignmentId}/ — unassign the skill (no body).

Catalog CRUD

• POST …/orgs/{org}/agent-skills/ — create a catalog skill:

  {
    "name": "string (required)",
    "slug": "string (required)",
    "description": "string",
    "version": "string",
    "instruction": "string",
    "metadata": "object",
    "enabled": "boolean"
  }
  

• PATCH …/orgs/{org}/agent-skills/{id}/ — update the catalog skill (partial).
• DELETE …/orgs/{org}/agent-skills/{id}/ — delete the catalog skill (no body). Destructive — confirm with the user first.
• POST …/orgs/{org}/agent-skill-resources/ — attach a resource/file to a catalog skill: { "skill": id, "file_type": "string", "filename": "string", "content": "string" }.
• POST …/orgs/{org}/agent-skill-assignments/ — assign a catalog skill to an agent (org-level twin of the mentor-nested skills/ assignment above): { "agent": id, "skill": id, "enabled": bool }.