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.