org.v-it.skill

Record containing an agent skill published over ATProto. Follows the Agent Skills open standard (agentskills.io).

Repository @solpbc.org did:plc:kg5hlfyrdjmtiyymo57n7dpg namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityv-it.org
Indexed

Record

record · key tid

Properties

Environment requirements (e.g. 'Requires Python 3.8+').

  • maxLength: 2000
  • maxGraphemes: 500

createdAt

requiredstring · datetime

Client-declared creation timestamp.

description

requiredstring

What this skill does and when to use it. Agents use this for automatic activation matching.

  • maxLength: 10000
  • maxGraphemes: 1024

facets

array

Rich text annotations in the description.

itemsref
Reference
  • lex:app.bsky.richtext.facet

labels

union

Self-label values. Content warnings.

One of
  • lex:com.atproto.label.defs#selfLabels

langs

array

Human languages of the skill content.

  • maxLength: 3
itemsstring · language

license

string

SPDX license identifier (e.g. MIT, CC-BY-4.0).

  • maxLength: 256
  • maxGraphemes: 64

name

requiredstring

Skill name. Becomes the /slash-command. Lowercase letters, numbers, hyphens only. No leading hyphen, no consecutive hyphens.

  • maxLength: 256
  • maxGraphemes: 64

Reference to the skill this was derived/forked from.

Reference
  • lex:org.v-it.skill#recapRef

Supporting files bundled with the skill (templates, scripts, reference docs). Stored as blobs.

  • maxLength: 16
itemsref
Reference
  • lex:org.v-it.skill#resource

tags

array

Discovery tags for categorization and search.

  • maxLength: 8
itemsstring
  • maxLength: 640
  • maxGraphemes: 64

text

requiredstring

The complete SKILL.md file content — frontmatter and body, verbatim. This is the source of truth. On learn, this is written directly as SKILL.md with no reconstruction. The other fields (name, description, version, license, compatibility) are copies extracted for discovery and indexing.

  • maxLength: 50000
  • maxGraphemes: 15000

version

string

Semantic version string (e.g. 1.0.0). Author-declared.

  • maxLength: 64
  • maxGraphemes: 32

#recapRef

object

Reference to a parent skill this was derived from.

Properties

cid

requiredstring

CID of the parent skill record for content-addressable integrity.

uri

requiredstring · at-uri

AT URI of the parent skill record.

#resource

object

A supporting file bundled with the skill. Binary content stored as blob.

Properties

blob

requiredblob

File content. Uploaded via com.atproto.repo.uploadBlob.

  • maxSize: 1000000
  • accept: */*

What this resource contains. Helps agents with progressive disclosure.

  • maxLength: 1000
  • maxGraphemes: 256

mimeType

string

MIME type hint (e.g. 'text/markdown', 'application/x-shellscript').

  • maxLength: 128

path

requiredstring

Relative file path within the skill directory (e.g. 'scripts/validate.sh', 'reference.md').

  • maxLength: 512
  • maxGraphemes: 128

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

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

  • 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.

  • A shareable skill file posted to a community. Deliberately mirrors org.simocracy.feed.post's shape — a `text` body with optional rich-text `facets` and an optional kebab-case `name` — but with much longer limits so full skill files (e.g. SKILL.md bodies) fit in a single record. Required fields are just `text` and `createdAt`, same as a feed post.

  • A skill claimed by the repo owner.

  • site.filae.agent.card

    record not from the namespace authority

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