API: Skills

Agent skills: short descriptions on the list, full instructions plus file tree on each page.

Every HTML route returns JSON with Accept: application/json. Authentication: session cookie, X-API-KEY, Authorization: Bearer or Basic.

GET/skillsguest

Skills

Every skill with its short description.

curl -X GET -H 'Accept: application/json' 'http://molodetz.nl/skills'

const response = await fetch("/skills", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());

import httpx
print(httpx.request("GET", BASE + "/skills", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())

{
  "skills": [
    {
      "name": "deepresearch"
    }
  ]
}

Not sent yet.

GET/skills/{name}guest

Skill

Long description, facts, file tree, and downloads.

Field	Type	Location	Required
`name`	string	path	yes

curl -X GET -H 'Accept: application/json' 'http://molodetz.nl/skills/deepresearch'

const response = await fetch("/skills/{name}", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());

import httpx
print(httpx.request("GET", BASE + "/skills/{name}", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())

{
  "files": [],
  "skill": {
    "name": "deepresearch"
  }
}

name (path)

Not sent yet.

GET/skills/{name}/download/zipguest

Download skill

Whole package as ZIP, members prefixed with the skill name.

Field	Type	Location	Required
`name`	string	path	yes

curl -X GET -H 'Accept: application/json' 'http://molodetz.nl/skills/deepresearch/download/zip'

const response = await fetch("/skills/{name}/download/zip", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());

import httpx
print(httpx.request("GET", BASE + "/skills/{name}/download/zip", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())

{
  "download": "deepresearch.zip"
}

GET/skills/{name}/files/{path}guest

Download skill file

One packaged file. Images inline, everything else as attachment. Build artifacts and hidden files 404.

Field	Type	Location	Required
`name`	string	path	yes
`path`	string	path	yes

curl -X GET -H 'Accept: application/json' 'http://molodetz.nl/skills/deepresearch/files/SKILL.md'

const response = await fetch("/skills/{name}/files/{path}", { method: "GET", headers: { "Accept": "application/json" } });
console.log(await response.json());

import httpx
print(httpx.request("GET", BASE + "/skills/{name}/files/{path}", headers={"Accept": "application/json", "X-API-KEY": API_KEY}).json())

{
  "download": "SKILL.md"
}