Create a skill - Docs by LangChain

{ "commit_hash": "9f1e2d3c4b5a", "commit_id": "c_8a7b6c5d", "created_at": "2026-01-15T09:30:00Z", "description": "Researches a topic across the web and writes a brief.", "files": {}, "id": "skill_3f9a2b1c", "name": "web-research", "owners": [ { "created_at": "2026-01-15T09:30:00Z", "email": "dev@example.com", "full_name": "Ada Lovelace", "identity_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0", "ls_user_id": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809" } ], "updated_at": "2026-01-15T09:30:00Z", "visibility": "workspace" }

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Body

application/json

Skill name and initial file tree

files

object

required

Show child attributes

name

string

required

Maximum string length: 64

Response

Created

commit_hash

string

Content hash of the current skill revision.

Example:

"9f1e2d3c4b5a"

commit_id

string

Omitted on the lightweight list (include_files=false): commit_id is not on the upstream repos-list contract, only commit_hash is.

Example:

"c_8a7b6c5d"

created_at

string

Example:

"2026-01-15T09:30:00Z"

description

string

Short summary derived from the skill's SKILL.md front matter.

Example:

"Researches a topic across the web and writes a brief."

files

object

File tree keyed by path; populated only when include_files=true.

Show child attributes

string

Example:

"skill_3f9a2b1c"

name

string

Example:

"web-research"

owners

object[]

Show child attributes

updated_at

string

Example:

"2026-01-15T09:30:00Z"

visibility

string

Who can see the skill: private, workspace, or public.

Example:

"workspace"