create-oasf-record

Create OASF Agent Record

Use this skill to register an AI agent or MCP server in the AGNTCY Agent Directory by generating a valid OASF record.

Record structure

An OASF record is a JSON document describing an AI agent or MCP server. Required top-level fields:

• name — URL-based identifier, e.g. "https://github.com/example/my-agent"
• version — semver string, e.g. "v1.0.0"
• description — human-readable summary
• skills — array of OASF skill objects ({ "id": "...", "name": "..." })
• locators — array of deployment locators (Docker image, PyPI, npm, etc.)

Workflow

1. Generate the record

Use the create_record prompt to analyze the current codebase and produce a draft OASF record:

/create_record

The prompt inspects the repo structure, README, and code to infer:

• Agent name, version, and description
• Applicable skills and domains from the OASF taxonomy
• Locators (Docker image, package URL, etc.)
• Authors and license

Optionally specify an output path:

/create_record output_path=agent.json

2. Explore the skill taxonomy (optional)

If the generated skills look off, browse the OASF taxonomy to find better matches:

Call agntcy_oasf_get_schema_skills with version="1.0.0"

Then drill into a category:

Call agntcy_oasf_get_schema_skills with version="1.0.0", parent_skill="Software Development"

Use the returned id values in the record's skills array.

3. Validate the record

Validate the JSON before publishing:

Call agntcy_oasf_validate_record with record_json=<the record JSON string>

Fix any validation_errors reported. Common issues:

• Missing required fields (name, version, description)
• Invalid skill or domain IDs (use the taxonomy tools to find correct IDs)
• Malformed locators

4. Publish to the Directory

Once the record is valid, push it:

Call agntcy_dir_push_record with record_json=<the validated record JSON>

Save the returned cid — it is the content-addressable identifier for this record version and the canonical reference for it; there is no other way to retrieve the exact same record later without re-pushing.