# org.simocracy.skill

> Published by [gainforest.earth](https://lexicon.garden/identity/did:plc:qoti4acfmc5wg6zzmtix6hse)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/org.simocracy.skill)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/org.simocracy.skill/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/org.simocracy.skill/examples)

## Definitions

### `org.simocracy.skill`

**Type**: `record`

A skill that sims can use in governance events — allocation mechanisms, evaluation methods, deliberation protocols.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes |  |
| `skillMd` | `string` | No | Full skill.md content that agents read to understand and execute this mechanism. Stored directly in the record. |
| `category` | `string` | No | Mechanism category |
| `skillUrl` | `string` | No | URL to the skill.md that agents read to execute this mechanism |
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No | Full explanation of how the mechanism works |
| `shortDescription` | `string` | Yes | Brief summary for cards |

## Raw Schema

```json
{
  "id": "org.simocracy.skill",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "shortDescription",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 3000,
            "maxGraphemes": 300
          },
          "skillMd": {
            "type": "string",
            "maxLength": 100000,
            "description": "Full skill.md content that agents read to understand and execute this mechanism. Stored directly in the record.",
            "maxGraphemes": 10000
          },
          "category": {
            "type": "string",
            "maxLength": 1000,
            "description": "Mechanism category",
            "knownValues": [
              "allocation",
              "evaluation",
              "deliberation"
            ]
          },
          "skillUrl": {
            "type": "string",
            "maxLength": 5000,
            "description": "URL to the skill.md that agents read to execute this mechanism"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "description": "Full explanation of how the mechanism works",
            "maxGraphemes": 3000
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 3000,
            "description": "Brief summary for cards",
            "maxGraphemes": 300
          }
        }
      },
      "description": "A skill that sims can use in governance events — allocation mechanisms, evaluation methods, deliberation protocols."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```