---
title: "actor.skill-listing@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/actor.skill-listing@1"
updated: null
---

# actor.skill-listing@1 · OpenVibe.Services

HTML: [actor.skill-listing@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/actor.skill-listing@1)

# ActorSkillListing `actor.skill-listing@1`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

An older major, still in the catalog. The current one is [`actor.skill-listing@2`](/docs/contracts/actor.skill-listing).

- Version: 1.0.0
- Owner: actor
- Visibility: public
- Status: active
- Compatibility: backward
- Decision: [ADR-058](/docs/adr/ADR-058)
- Schema: [`https://openvibe.network/contracts/actor/skill-listing.v1.json`](/docs/contracts/actor.skill-listing@1.json)

actor.skill-listing@1: a skill in the registry, the record every site shows on its card (ADR-058). It carries the document as published (actor.skill@1), the PUBLISHER from the registry's own record (vouched: unlike the document's author, this is who published it), the SCAN (its state and findings travel with the listing), and the CURATOR's state. Install rules every site keeps: a passed skill installs in one tap; a flagged one only after the person reads the findings and confirms; a failed one never; a stale or archived one is not offered. Installing copies the document into the person's agent; it grants nothing (the skill's requires is a declaration).

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `listing` | const | yes |  | - `= "actor.skill-listing@1"` |
| `id` | string | yes | The listing's id. | - `pattern ^skl_[0-9A-HJKMNP-TV-Z]{26}$` |
| `skill` | [actor.skill@1](/docs/contracts/actor.skill@1) | yes | The document as published. |  |
| `publisher` | object | yes | Who published it, from the registry's own record. | - `no other fields` |
| `publisher.kind` | enum | yes | OpenVibe's own skills, or a person's. | - `one of "openvibe", "person"` |
| `publisher.subject` | string |  | The person who published it (kind person). | - `pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$` |
| `publisher.name` | string |  |  | - `minLength 1`<br>- `maxLength 80` |
| `scan` | object | yes | What the registry's scan found. It travels with the listing. | - `no other fields` |
| `scan.state` | enum | yes |  | - `one of "pending", "passed", "flagged", "failed"` |
| `scan.scanner` | string |  | The scanner and its version. | - `minLength 1`<br>- `maxLength 80` |
| `scan.scanned_at` | string |  |  | - `format date-time` |
| `scan.findings` | array of object |  |  | - `maxItems 50`<br>- `items: no other fields` |
| `scan.findings[].rule` | string | yes | Which rule, such as asks.undeclared\_kind or text.secret\_request. | - `pattern ^[a-z][a-z0-9_.-]{1,63}$` |
| `scan.findings[].severity` | enum | yes |  | - `one of "info", "warn", "block"` |
| `scan.findings[].where` | string |  | instructions, description, or a resource path. | - `maxLength 120` |
| `scan.findings[].note` | string | yes | What it found, in plain words. | - `minLength 1`<br>- `maxLength 280` |
| `curator` | object | yes | The curator ships with the catalogue: what is used stays, what is not goes stale. | - `no other fields` |
| `curator.state` | enum | yes |  | - `one of "active", "stale", "archived"` |
| `curator.last_used_at` | string |  |  | - `format date-time` |
| `curator.near_duplicate_of` | string |  | A listing that does the same job. | - `pattern ^skl_[0-9A-HJKMNP-TV-Z]{26}$` |
| `installs` | integer |  |  | - `minimum 0` |
| `listed_at` | string | yes |  | - `format date-time` |
| `retired_at` | string |  |  | - `format date-time` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

The fixtures that ship with the package are the current major's.

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('actor.skill-listing@1', value);   // { valid, errors: [{ path, message }] }
~~~~