full diff

com.publicdomainrelay.temp.agent.skill

johnandersen777.bsky.social +1 −9

← Back to Compare Lexicon page

From

bafyreibum3yfkn6q5we7lzagbni5v4oo3o3r3zpopgicpftneyyi4egb5q indexed 2026-05-29 23:32 UTC View this version

bafyreibpxaxjqvutglzcsdm44ljbfworby3ye6nfgf7skx45yippgj5vke indexed 2026-06-06 20:13 UTC View this version

Compatibility

breaking 5 breaking changes, 0 non-breaking changes.

Breaking changes (5)

RemovedVertex RemovedVertex { vertex_id: "com.publicdomainrelay.temp.agent.skill:body.tools" }
RemovedVertex RemovedVertex { vertex_id: "com.publicdomainrelay.temp.agent.skill:body.tools:items" }
RemovedEdge RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body", tgt: "com.publicdomainrelay.temp.agent.skill:body.tools", kind: "prop", name: Some("tools") }
RemovedEdge RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body.tools", tgt: "com.publicdomainrelay.temp.agent.skill:body.tools:items", kind: "items", name: None }
RemovedEdge RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body.tools:items", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }

Migration guidance

Removed

RemovedVertex { vertex_id: "com.publicdomainrelay.temp.agent.skill:body.tools" }
RemovedVertex { vertex_id: "com.publicdomainrelay.temp.agent.skill:body.tools:items" }

Notes

Breaking: RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body", tgt: "com.publicdomainrelay.temp.agent.skill:body.tools", kind: "prop", name: Some("tools") }
Breaking: RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body.tools", tgt: "com.publicdomainrelay.temp.agent.skill:body.tools:items", kind: "items", name: None }
Breaking: RemovedEdge { src: "com.publicdomainrelay.temp.agent.skill:body.tools:items", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

44 "main": {

      "description": "An agent skill record that describes a capability the agent can perform, with examples, property references, and optionally TypeScript tools the agent can invoke.",

      "description": "An agent skill record that describes a capability the agent can perform, with examples and property references.",

66 "key": "tid",

77 "record": {

88 "properties": {

99 "content": {

1010 "description": "The skill itself.",

1111 "type": "string"

1212 },

1313 "createdAt": {

1414 "description": "ISO 8601 timestamp when this skill record was created.",

1515 "type": "string"

1616 },

1717 "description": {

1818 "description": "Instructions for when and how to use this skill.",

1919 "type": "string"

2020 },

2121 "examples": {

2222 "description": "Strong references to example records demonstrating this skill.",

2323 "items": {

2424 "ref": "com.atproto.repo.strongRef",

2525 "type": "ref"

2626 },

2727 "type": "array"

2828 },

2929 "name": {

3030 "description": "Human-readable name of the skill.",

3131 "type": "string"

3232 },

3333 "property_references": {

3434

            "description": "Annotated path-value pairs describing fields within the example records. Each entry either carries a literal string value or a strongRef that resolves (recursively) to the value at that path.",

3535 "items": {

3636 "ref": "#propertyReference",

37 "type": "ref"

38 },

39 "type": "array"

40 },

41 "tools": {

            "description": "TypeScript tools the skill provides. Each entry is a strongRef to a com.publicdomainrelay.temp.agent.tool.typescript record (which carries the FULL embedded source, deno.json, and deno.lock). Decoupling from the agent.skill record means the same tool can be referenced from multiple skills, and a remote agent fetching this skill can resolve and execute the tool without filesystem access.",

43 "items": {

44 "ref": "com.atproto.repo.strongRef",

4537 "type": "ref"

4638 },

4739 "type": "array"

4840 }

4941 },

5042 "required": [

5143 "name",

5244 "description",

5345 "content",

5446 "createdAt"

5547 ],

5648 "type": "object"

5749 },

5850 "type": "record"

5951 },

6052 "propertyReference": {

6153

      "description": "A single path-annotated value reference within a skill's example records. Carries either a literal string or a strongRef pointing to the value.",

6254 "properties": {

6355 "path": {

6456

          "description": "JSONPath-like dotted path into the resolved example tree, e.g. '.examples[].value.payload.value.user_data'.",

6557 "type": "string"

6658 },

6759 "ref": {

6860 "description": "Strong reference to a record that contains the example data.",

6961 "ref": "com.atproto.repo.strongRef",

7062 "type": "ref"

7163 }

7264 },

7365 "required": [

7466 "path"

7567 ],

7668 "type": "object"

7769 }

7870 },

7971 "id": "com.publicdomainrelay.temp.agent.skill",

8072 "lexicon": 1