catalog

Update an agent catalog via REST PATCH with role, expertise, and status.

16|4|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/idchain-world/id-agents --skill catalog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: catalog
Source: https://github.com/idchain-world/id-agents/tree/main/skills/catalog
Command: npx skills add https://github.com/idchain-world/id-agents --skill catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update and publish your agent's capabilities, role, and status to ensure teammates and managers have an accurate view of skills and availability.

Core Features & Use Cases

  • Update the REST endpoint /catalog with a JSON payload to reflect role, description, expertise, and currentTask.
  • Use cases include onboarding, status changes, and capability broadcasting to a team or manager.

Quick Start

Use curl to PATCH http://localhost:$ID_AGENT_PORT/catalog with a JSON body describing your role, expertise, and current status.

Frequently Asked Questions about catalog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an agent's role and status in a local catalog via REST API?▼

To update an agent catalog via REST, send a PATCH request to http://localhost:$ID_AGENT_PORT/catalog with a JSON payload containing description, role, expertise, status, and optional currentTask to reflect real-time availability.

What JSON payload fields are required to patch an agent catalog endpoint?▼

The agent catalog PATCH endpoint requires a JSON payload with description, role, expertise, and status fields, plus an optional currentTask field to broadcast current activities to teammates and managers.

Can I broadcast agent capability changes to teammates using a local REST endpoint?▼

Yes, you can broadcast agent capability changes by sending a PATCH request to the local /catalog REST endpoint, which publishes your agent's updated role, expertise, and availability to teammates and managers in real time.

Does the catalog update skill require any external dependencies or components?▼

No, the catalog update skill operates with zero dependencies and no additional components, requiring only a local REST endpoint available at http://localhost:$ID_AGENT_PORT/catalog to accept the PATCH request.

What's the best way to keep an agent catalog up-to-date during onboarding or status changes?▼

The best way to keep an agent catalog current is sending a PATCH request to the /catalog endpoint with updated JSON fields whenever onboarding occurs, status changes, or capabilities need broadcasting to the team.

Why should I use a PATCH request instead of POST for agent catalog updates?▼

Using a PATCH request for agent catalog updates applies partial modifications to existing role, expertise, and status fields without replacing the entire resource, making it ideal for real-time availability broadcasting.