Create Skill Version

client.Skills.Versions.New(ctx, skillID, body) (*SkillVersion, error)

POST/v1/skills/{skill_id}/versions

Parameters

skillID string

Unique identifier for the skill.

The format and length of IDs may change over time.

body SkillVersionNewParams

Files param.Field[[]Reader]

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.

Returns

type SkillVersion struct{…}

ID string

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

CreatedAt Time

ISO 8601 timestamp of when the skill was created.

formatdate-time

Description string

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

Name string

The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter name (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.

SkillID string

Unique identifier for the skill.

The format and length of IDs may change over time.

Type SkillVersion

Object type.

For Skill Versions, this is always "skill_version".

defaultskill_version

Create Skill Version

package main

import (
	"bytes"
	"context"
	"fmt"
	"io"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/option"
)

func main() {
	client := anthropic.NewClient(
		option.WithAPIKey("my-anthropic-api-key"),
	)
	skillVersion, err := client.Skills.Versions.New(
		context.TODO(),
		"skill_id",
		anthropic.SkillVersionNewParams{
			Files: []io.Reader{io.Reader(bytes.NewBuffer([]byte("Example data")))},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", skillVersion.ID)
}

{
  "id": "id",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "description",
  "name": "name",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_version"
}

Returns Examples

{
  "id": "id",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "description",
  "name": "name",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_version"
}