Создать навык

$client->skills->create(list<string> files, ?string displayName, ?string workspaceID): Skill

POST/v1/skills

Создать навык

Parameters

files: list<string>

Files to upload for the skill.

All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.

displayName?:optional string

Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

workspaceID?:optional string

Returns

class Skill { $type = 'skill'; $id; $createdAt; /* 4 more */ }

"skill" type

Object type.

For Skills, this is always "skill".

string id

Unique identifier for the skill.

The format and length of IDs may change over time.

\Datetime createdAt

ISO 8601 timestamp of when the skill was created.

string displayName

Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

string latestVersionID

ID of the newest Skill Version — what latest references resolve to. Always set: a Skill holds at least one version.

SkillSource source

Where the Skill comes from.

Possible values:

"custom": authored by the platform user; private to their workspace
"anthropic": published by Anthropic; shared and read-only
"anthropic_example": Anthropic-published sample Skill
"plugin": resolved from an installed plugin

\Datetime updatedAt

ISO 8601 timestamp of when the skill was last updated.

Создать навык

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'my-anthropic-api-key');

$skill = $client->skills->create(
  files: [
    FileParam::fromString('Example data', filename: uniqid('file-upload-', true)),
  ],
  displayName: 'display_name',
  workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy',
);

var_dump($skill);

Response 200

{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "display_name",
  "latest_version_id": "latest_version_id",
  "source": {
    "type": "custom"
  },
  "type": "skill",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Returns Examples

Response 200

{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "display_name",
  "latest_version_id": "latest_version_id",
  "source": {
    "type": "custom"
  },
  "type": "skill",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}