# The Skill object

A Skill is an agentskills.io bundle registered in Unity Catalog. Clients
 transfer bundle bytes through the Files API. FinalizeSkill reads the uploaded
 SKILL.md and projects its frontmatter onto the Skill metadata.

## Attributes

- `name` (string, Beta, ID, Immutable)
  Resource name of the skill.
   Format: `skills/{catalog}.{schema}.{skill}`.
   Each `{...}` component is capped at 255 characters individually.
    Server-derived on Create from `parent` +
   `skill_id`; required and immutable on Update/Get/Delete.
- `bundle_name` (string, Beta, Output only)
  Name from the most recently successfully finalized SKILL.md. It may differ
   from the final component of the Skill resource name. Unset until
   FinalizeSkill succeeds.
- `description` (string, Beta, Output only)
  Description from the most recently successfully finalized SKILL.md. Unset
   until FinalizeSkill succeeds.
- `etag` (string, Beta, Output only)
  Optimistic concurrency token returned on every read. To make an Update or
   Delete conditional, pass the last-read value in that request's `etag`
   field. In REST responses, this value is a base64 string; URL-encode it when
   setting the `etag` query parameter.
- `create_time` (string, Beta, Output only)
  Time the skill was created.
- `update_time` (string, Beta, Output only)
  Time of the most recent Skill metadata mutation. Uploading bundle files
   alone does not change this value.
- `finalize_time` (string, Beta, Output only)
  Time of the most recent successful FinalizeSkill. Unset until one succeeds.
- `created_by` (string, Beta, Output only)
  Creator identity.
- `updated_by` (string, Beta, Output only)
  Identity of the last updater.
- `effective_owner` (string, Beta, Output only)
  Owner of the skill.
- `metastore_id` (string, Beta, Output only)
  Metastore hosting the skill.
- `comment` (string, Beta)
  User-provided comment for the skill. Free-text, user-editable via
   UpdateSkill (listed in its `update_mask`). DISTINCT from `description`,
   which is the server-parsed, OUTPUT_ONLY SKILL.md frontmatter value: `comment`
   is the customer's own annotation and is preserved across bundle re-uploads.
   When `comment` is in the update mask, omitting it clears the field, while
   an explicitly empty string is retained.

## Example

```json
{
  "name": "string",
  "bundle_name": "string",
  "description": "string",
  "etag": "string",
  "create_time": "string",
  "update_time": "string",
  "finalize_time": "string",
  "created_by": "string",
  "updated_by": "string",
  "effective_owner": "string",
  "metastore_id": "string",
  "comment": "string"
}
```