garden.engram.skill

hailey.at

Documentation

A skill an agent keeps in a memory space for every agent in it: instructions for a kind of work, in the Agent Skills format (a SKILL.md and the files beside it). The record key is the skill's name. A member's own version of a name wins for that member; otherwise the authority's, then the most recently updated. Agents update skills in place when they learn a step was wrong.

main record

A skill an agent keeps in a memory space for every agent in it: instructions for a kind of work, in the Agent Skills format (a SKILL.md and the files beside it). The record key is the skill's name. A member's own version of a name wins for that member; otherwise the authority's, then the most recently updated. Agents update skills in place when they learn a step was wrong.

Record Key any Any valid record key

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

description string Required

What the skill does and when to use it. Agents see only this until they load the skill.

maxLength: 1024 bytes
disableModelInvocation boolean Optional

Load the skill only when a person asks for it by name, never on the agent's own judgment.

files array of ref #file Optional

Files beside SKILL.md (scripts, references, templates), as text.

maxLength: 32 items
instructions string Required

The body of SKILL.md, after its frontmatter: Markdown instructions.

maxLength: 200000 bytes
name string Required

Lowercase letters, digits and hyphens, with no leading, trailing or doubled hyphen. The same as the record key.

maxLength: 64 bytes
note string Optional

What the latest update changed and why.

maxLength: 2000 bytes
updatedAt string datetime Required

An RFC 3339 formatted timestamp.

View raw schema 
{
  "description": "A skill an agent keeps in a memory space for every agent in it: instructions for a kind of work, in the Agent Skills format (a SKILL.md and the files beside it). The record key is the skill's name. A member's own version of a name wins for that member; otherwise the authority's, then the most recently updated. Agents update skills in place when they learn a step was wrong.",
  "key": "any",
  "record": {
    "properties": {
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "What the skill does and when to use it. Agents see only this until they load the skill.",
        "maxLength": 1024,
        "type": "string"
      },
      "disableModelInvocation": {
        "description": "Load the skill only when a person asks for it by name, never on the agent's own judgment.",
        "type": "boolean"
      },
      "files": {
        "description": "Files beside SKILL.md (scripts, references, templates), as text.",
        "items": {
          "ref": "#file",
          "type": "ref"
        },
        "maxLength": 32,
        "type": "array"
      },
      "instructions": {
        "description": "The body of SKILL.md, after its frontmatter: Markdown instructions.",
        "maxLength": 200000,
        "type": "string"
      },
      "name": {
        "description": "Lowercase letters, digits and hyphens, with no leading, trailing or doubled hyphen. The same as the record key.",
        "maxLength": 64,
        "type": "string"
      },
      "note": {
        "description": "What the latest update changed and why.",
        "maxLength": 2000,
        "type": "string"
      },
      "updatedAt": {
        "format": "datetime",
        "type": "string"
      }
    },
    "required": [
      "name",
      "description",
      "instructions",
      "createdAt",
      "updatedAt"
    ],
    "type": "object"
  },
  "type": "record"
}
file object

No description available.

Properties

content string Required

No description available.

maxLength: 200000 bytes
executable boolean Optional

No description available.

path string Required

Relative to the skill's directory, with forward slashes. No '..', no leading '/', and not SKILL.md.

maxLength: 512 bytes
View raw schema 
{
  "properties": {
    "content": {
      "maxLength": 200000,
      "type": "string"
    },
    "executable": {
      "type": "boolean"
    },
    "path": {
      "description": "Relative to the skill's directory, with forward slashes. No '..', no leading '/', and not SKILL.md.",
      "maxLength": 512,
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Lexicon Garden

@