FullSkill API

curl -X POST https://fullskill.ai/api/v1/builds \
  -H "Authorization: Bearer fs_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "A skill that helps AI agents write production-ready API documentation following OpenAPI standards.",
    "problem": "Without this skill, API docs are inconsistent, miss edge cases, and lack proper schema definitions.",
    "audience": "Backend developers who need to document REST APIs.",
    "use_cases": [
      "When I need to document a new REST endpoint",
      "When I need to generate OpenAPI specs from code",
      "When I need to review existing API docs for completeness"
    ],
    "quality": "marketplace"
  }'

import requests

response = requests.post(
    "https://fullskill.ai/api/v1/builds",
    headers={
        "Authorization": "Bearer fs_live_your_key_here",
        "Content-Type": "application/json",
    },
    json={
        "description": "A skill that helps AI agents write production-ready API documentation.",
        "problem": "API docs are inconsistent and miss edge cases.",
        "audience": "Backend developers documenting REST APIs.",
        "use_cases": [
            "When I need to document a new REST endpoint",
            "When I need to generate OpenAPI specs from code",
            "When I need to review existing API docs for completeness",
        ],
        "quality": "marketplace",
    },
)

data = response.json()
print(f"Build started: {data['build_id']}")
print(f"Poll status at: {data['poll_url']}")

const response = await fetch("https://fullskill.ai/api/v1/builds", {
  method: "POST",
  headers: {
    "Authorization": "Bearer fs_live_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    description: "A skill that helps AI agents write production-ready API documentation.",
    problem: "API docs are inconsistent and miss edge cases.",
    audience: "Backend developers documenting REST APIs.",
    use_cases: [
      "When I need to document a new REST endpoint",
      "When I need to generate OpenAPI specs from code",
      "When I need to review existing API docs for completeness",
    ],
    quality: "marketplace",
  }),
});

const data = await response.json();
console.log(`Build started: ${data.build_id}`);

curl https://fullskill.ai/api/v1/builds/{build_id} \
  -H "Authorization: Bearer fs_live_your_key_here"

response = requests.get(
    f"https://fullskill.ai/api/v1/builds/{build_id}",
    headers={"Authorization": "Bearer fs_live_your_key_here"},
)

build = response.json()
print(f"Status: {build['status']} ({build['completion_pct']}%)")

const response = await fetch(`https://fullskill.ai/api/v1/builds/${buildId}`, {
  headers: { "Authorization": "Bearer fs_live_your_key_here" },
});

const build = await response.json();
console.log(`Status: ${build.status} (${build.completion_pct}%)`);

curl https://fullskill.ai/api/v1/builds/{build_id}/files \
  -H "Authorization: Bearer fs_live_your_key_here"

response = requests.get(
    f"https://fullskill.ai/api/v1/builds/{build_id}/files",
    headers={"Authorization": "Bearer fs_live_your_key_here"},
)

for file in response.json()["files"]:
    print(f"{file['path']} ({file['line_count']} lines)")
    with open(file["path"], "w") as f:
        f.write(file["content"])

const response = await fetch(
  `https://fullskill.ai/api/v1/builds/${buildId}/files`,
  { headers: { "Authorization": "Bearer fs_live_your_key_here" } },
);

const { files } = await response.json();
for (const file of files) {
  console.log(`${file.path} (${file.line_count} lines)`);
}

curl -o skill.zip https://fullskill.ai/api/v1/builds/{build_id}/download \
  -H "Authorization: Bearer fs_live_your_key_here"

response = requests.get(
    f"https://fullskill.ai/api/v1/builds/{build_id}/download",
    headers={"Authorization": "Bearer fs_live_your_key_here"},
)

with open("skill.zip", "wb") as f:
    f.write(response.content)

print(f"Downloaded {len(response.content)} bytes")

const response = await fetch(
  `https://fullskill.ai/api/v1/builds/${buildId}/download`,
  { headers: { "Authorization": "Bearer fs_live_your_key_here" } },
);

const blob = await response.blob();
// In Node.js, write to file:
const buffer = Buffer.from(await blob.arrayBuffer());
require("fs").writeFileSync("skill.zip", buffer);

curl -N https://fullskill.ai/api/v1/builds/{build_id}/events \
  -H "Authorization: Bearer fs_live_your_key_here" \
  -H "Accept: text/event-stream"

import sseclient
import requests

response = requests.get(
    f"https://fullskill.ai/api/v1/builds/{build_id}/events",
    headers={"Authorization": "Bearer fs_live_your_key_here"},
    stream=True,
)

client = sseclient.SSEClient(response)
for event in client.events():
    data = json.loads(event.data)
    print(f"[{data['type']}] {data.get('message', '')}")

const response = await fetch(
  `https://fullskill.ai/api/v1/builds/${buildId}/events`,
  { headers: { "Authorization": "Bearer fs_live_your_key_here" } },
);

const reader = response.body!.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const text = decoder.decode(value);
  for (const line of text.split("\n")) {
    if (line.startsWith("data: ")) {
      const event = JSON.parse(line.slice(6));
      console.log(`[${event.type}] ${event.message || ""}`);
    }
  }
}

# Browse all skills
curl https://fullskill.ai/api/v1/catalog

# Filter by category
curl "https://fullskill.ai/api/v1/catalog?category=development"

# Search
curl "https://fullskill.ai/api/v1/catalog?search=api+documentation"

response = requests.get(
    "https://fullskill.ai/api/v1/catalog",
    params={"category": "development", "limit": 10},
)

for skill in response.json()["skills"]:
    print(f"{skill['name']} - {skill['description']}")

const response = await fetch(
  "https://fullskill.ai/api/v1/catalog?category=development&limit=10",
);

const { skills } = await response.json();
skills.forEach((s: any) => console.log(`${s.name}: ${s.description}`));

curl https://fullskill.ai/api/v1/catalog/api-doc-writer

response = requests.get(
    "https://fullskill.ai/api/v1/catalog/api-doc-writer",
)

skill = response.json()
print(f"{skill['name']}: {skill['file_count']} files, {skill['line_count']} lines")

const response = await fetch(
  "https://fullskill.ai/api/v1/catalog/api-doc-writer",
);

const skill = await response.json();
console.log(`${skill.name}: ${skill.file_count} files`);

# Download and extract to Claude Code skills directory
curl -o skill.zip https://fullskill.ai/api/v1/catalog/api-doc-writer/install
unzip skill.zip -d ~/.claude/skills/

import zipfile
import io

response = requests.get(
    "https://fullskill.ai/api/v1/catalog/api-doc-writer/install",
)

with zipfile.ZipFile(io.BytesIO(response.content)) as z:
    z.extractall("~/.claude/skills/")

const response = await fetch(
  "https://fullskill.ai/api/v1/catalog/api-doc-writer/install",
);

const buffer = Buffer.from(await response.arrayBuffer());
require("fs").writeFileSync("skill.zip", buffer);
// Then: unzip skill.zip -d ~/.claude/skills/