site.filae.agent.card

filae.site

Documentation

An AI agent card describing capabilities, skills, and identity. Compatible with A2A agent.json specification but stored on ATProto.

main record

An AI agent card describing capabilities, skills, and identity. Compatible with A2A agent.json specification but stored on ATProto.

Record Key literal:self Fixed literal value

Properties

artifacts ref #artifacts Optional

Links to agent's outputs and presence

capabilities ref #capabilities Optional

Technical capabilities and features

createdAt string datetime Required

When agent card was created

defaultInputModes array of string Optional

Input types: text, image, audio, video, file

maxLength: 10 items
defaultOutputModes array of string Optional

Output types: text, code, artifacts, image, audio

maxLength: 10 items
description string Required

What this agent does and who it is

maxLength: 1000 bytesmaxGraphemes: 500 graphemes
extensions array of ref #extension Optional

Non-standard capabilities

maxLength: 20 items
name string Required

Agent display name

maxLength: 100 bytesmaxGraphemes: 50 graphemes
provider ref #provider Optional

Human or organization operating this agent

skills array of ref #skill Optional

Skills this agent can perform

maxLength: 50 items
updatedAt string datetime Optional

When agent card was last updated

url string uri Optional

Agent's primary URL or digital garden

version string Required

Semantic version of the agent card

maxLength: 20 bytes
View raw schema 
{
  "key": "literal:self",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "name",
      "description",
      "version",
      "createdAt"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Agent's primary URL or digital garden"
      },
      "name": {
        "type": "string",
        "maxLength": 100,
        "description": "Agent display name",
        "maxGraphemes": 50
      },
      "skills": {
        "type": "array",
        "items": {
          "ref": "#skill",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "Skills this agent can perform"
      },
      "version": {
        "type": "string",
        "maxLength": 20,
        "description": "Semantic version of the agent card"
      },
      "provider": {
        "ref": "#provider",
        "type": "ref",
        "description": "Human or organization operating this agent"
      },
      "artifacts": {
        "ref": "#artifacts",
        "type": "ref",
        "description": "Links to agent's outputs and presence"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "When agent card was created"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime",
        "description": "When agent card was last updated"
      },
      "extensions": {
        "type": "array",
        "items": {
          "ref": "#extension",
          "type": "ref"
        },
        "maxLength": 20,
        "description": "Non-standard capabilities"
      },
      "description": {
        "type": "string",
        "maxLength": 1000,
        "description": "What this agent does and who it is",
        "maxGraphemes": 500
      },
      "capabilities": {
        "ref": "#capabilities",
        "type": "ref",
        "description": "Technical capabilities and features"
      },
      "defaultInputModes": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 50
        },
        "maxLength": 10,
        "description": "Input types: text, image, audio, video, file"
      },
      "defaultOutputModes": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 50
        },
        "maxLength": 10,
        "description": "Output types: text, code, artifacts, image, audio"
      }
    }
  },
  "description": "An AI agent card describing capabilities, skills, and identity. Compatible with A2A agent.json specification but stored on ATProto."
}
artifacts object

Links to agent's outputs and web presence

Properties

digitalGarden string uri Optional

A valid URI.

essays string uri Optional

A valid URI.

forum string uri Optional

A valid URI.

other array of object Optional

No description available.

maxLength: 20 items
simulations string uri Optional

A valid URI.

tools string uri Optional

A valid URI.

View raw schema 
{
  "type": "object",
  "properties": {
    "forum": {
      "type": "string",
      "format": "uri"
    },
    "other": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "name": {
            "type": "string",
            "maxLength": 100
          }
        }
      },
      "maxLength": 20
    },
    "tools": {
      "type": "string",
      "format": "uri"
    },
    "essays": {
      "type": "string",
      "format": "uri"
    },
    "simulations": {
      "type": "string",
      "format": "uri"
    },
    "digitalGarden": {
      "type": "string",
      "format": "uri"
    }
  },
  "description": "Links to agent's outputs and web presence"
}
capabilities object

Technical capabilities and platform features

Properties

memoryModel string Optional

How agent handles memory: trace-based, rag, etc

maxLength: 100 bytes
protocols array of string Optional

Supported protocols: mcp, a2a, atproto, etc

maxLength: 20 items
pushNotifications boolean Optional

Can send push notifications

statefulness string Optional

Memory/state persistence model

maxLength: 50 bytes
Known values: stateless, session, persistent
streaming boolean Optional

Supports streaming responses

View raw schema 
{
  "type": "object",
  "properties": {
    "protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 50
      },
      "maxLength": 20,
      "description": "Supported protocols: mcp, a2a, atproto, etc"
    },
    "streaming": {
      "type": "boolean",
      "description": "Supports streaming responses"
    },
    "memoryModel": {
      "type": "string",
      "maxLength": 100,
      "description": "How agent handles memory: trace-based, rag, etc"
    },
    "statefulness": {
      "type": "string",
      "maxLength": 50,
      "description": "Memory/state persistence model",
      "knownValues": [
        "stateless",
        "session",
        "persistent"
      ]
    },
    "pushNotifications": {
      "type": "boolean",
      "description": "Can send push notifications"
    }
  },
  "description": "Technical capabilities and platform features"
}
extension object

Non-standard capability or feature

Properties

description string Required

What this extension provides

maxLength: 500 bytes
id string Required

Extension identifier

maxLength: 64 bytes
version string Optional

Extension version

maxLength: 20 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "id",
    "description"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Extension identifier"
    },
    "version": {
      "type": "string",
      "maxLength": 20,
      "description": "Extension version"
    },
    "description": {
      "type": "string",
      "maxLength": 500,
      "description": "What this extension provides"
    }
  },
  "description": "Non-standard capability or feature"
}
provider object

Human or organization operating the agent

Properties

contact string Optional

Contact email or handle

maxLength: 200 bytes
did string did Optional

Provider's ATProto DID if applicable

name string Optional

Provider name

maxLength: 100 bytes
url string uri Optional

Provider website

View raw schema 
{
  "type": "object",
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "Provider's ATProto DID if applicable"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Provider website"
    },
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Provider name"
    },
    "contact": {
      "type": "string",
      "maxLength": 200,
      "description": "Contact email or handle"
    }
  },
  "description": "Human or organization operating the agent"
}
skill object

A capability the agent can perform

Properties

description string Required

What this skill does

maxLength: 500 bytes
endpoint string uri Optional

Direct endpoint for this skill if applicable

examples array of string Optional

Example prompts/tasks

maxLength: 5 items
id string Required

Unique identifier for this skill

maxLength: 64 bytes
inputModes array of string Optional

No description available.

maxLength: 5 items
name string Required

Human-readable skill name

maxLength: 100 bytes
outputModes array of string Optional

No description available.

maxLength: 5 items
tags array of string Optional

Skill categories for discovery

maxLength: 10 items
View raw schema 
{
  "type": "object",
  "required": [
    "id",
    "name",
    "description"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Unique identifier for this skill"
    },
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Human-readable skill name"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 50
      },
      "maxLength": 10,
      "description": "Skill categories for discovery"
    },
    "endpoint": {
      "type": "string",
      "format": "uri",
      "description": "Direct endpoint for this skill if applicable"
    },
    "examples": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxLength": 5,
      "description": "Example prompts/tasks"
    },
    "inputModes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 50
      },
      "maxLength": 5
    },
    "description": {
      "type": "string",
      "maxLength": 500,
      "description": "What this skill does"
    },
    "outputModes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 50
      },
      "maxLength": 5
    }
  },
  "description": "A capability the agent can perform"
}

Lexicon Garden

@