Read a Cactal agent skill

curl --request GET \
  --url https://api.cactal.ai/v1/skills/{skillId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cactal.ai/v1/skills/{skillId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "content": "<string>"
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

Documentation

Read a Cactal agent skill

Read the matching Cactal skill before acting: source-editing-workflow before source edits, design-direction for design, copywriting for words. Required skills are included.

analytics: Traffic, visitors, referrers, and other analytics reports
assets-and-media: Generate, import, or place images, video, fonts, favicons
cms-content-editing: Create, edit, publish, schedule, or delete CMS items
cms-data-in-pages: Show CMS content on pages with definePage queries
cms-item-queries: Filter, search, and sort CMS item lists
cms-modeling: Create or change CMS collections and fields
copywriting: Write or rewrite website copy
design-direction: New visual design or restyling of palette, type, and layout
forms: Forms, submissions, and notification recipients
image-reforming: Turn found or imperfect photos into better images
imports-and-modules: Imports, components, and shared modules
logo-design: Design or redraw a logo, brand mark, icon, or favicon
npm-packages: Add, upgrade, or debug npm packages
page-metadata-and-seo: Page metadata, SEO, social cards, and sitemaps
pages-and-routes: Create pages, routes, URL params, and a custom 404
publishing-and-recovery: Publish, roll back, restore, or unpublish the website
rendering-and-browser-apis: Browser-only APIs, Intl, and server render failures
server-functions: Server functions and website secrets
shaders: Build GPU effects with Paper Shaders or custom GLSL
source-editing-workflow: Read before any page, component, CSS, or config edit
source-files-and-naming: Create, delete, or name source files
styling-and-css: Global CSS, Tailwind theme, and fonts
validate-and-preview: Checks, diagnostics, screenshots, and deployments
web-research: Public web facts and studying reference sites
website-config: Redirects, response headers, and website_config
website-settings-and-domains: Rename the website or slug, hosts, custom domains, DNS

GET

skills

{skillId}

Read a Cactal agent skill

curl --request GET \
  --url https://api.cactal.ai/v1/skills/{skillId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cactal.ai/v1/skills/{skillId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "content": "<string>"
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

{
  "kind": "validation",
  "message": "<string>",
  "suggestion": "<string>",
  "validValues": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

Cactal API key. Create one in the dashboard or via POST /apiKeys. The plaintext key is shown once at creation.

Path Parameters

skillId

enum<string>

required

Skill to read; the skills it requires come with it.

Available options:

analytics,

assets-and-media,

cms-content-editing,

cms-data-in-pages,

cms-item-queries,

cms-modeling,

copywriting,

design-direction,

forms,

image-reforming,

imports-and-modules,

logo-design,

npm-packages,

page-metadata-and-seo,

pages-and-routes,

publishing-and-recovery,

rendering-and-browser-apis,

server-functions,

shaders,

source-editing-workflow,

source-files-and-naming,

styling-and-css,

validate-and-preview,

web-research,

website-config,

website-settings-and-domains

Response

The skill and the skills it requires, formatted as Markdown.

content

string

required

The skill and every skill it requires, dependencies first, as Markdown.

Getting started

Documentation

Web research

Feedback

Websites

Website editors

API keys

Source code

Publishing

CMS collections

CMS fields

CMS items

Domains

Assets

Project context

Analytics

Forms

Secrets

Server functions

Organizations

Audit log

Billing

Read a Cactal agent skill

Authorizations

Path Parameters

Response