> ## Documentation Index
> Fetch the complete documentation index at: https://cactal.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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



## OpenAPI

````yaml /api-reference/openapi.json get /skills/{skillId}
openapi: 3.1.0
info:
  title: Cactal API
  version: 1.0.0
  description: >-
    The Cactal public API. Create, edit, publish, and operate websites
    programmatically. Authenticate every request with an API key sent as
    `Authorization: Bearer <key>`.
servers:
  - url: https://api.cactal.ai/v1
security:
  - apiKey: []
tags:
  - name: Documentation
    description: >-
      Search and read the Cactal product documentation for concepts, guides,
      agent workflows, platform behavior, and API operations.
  - name: Feedback
    description: >-
      Submit free-form product feedback from users and agents to the Cactal
      feedback inbox.
  - name: Websites
    description: >-
      Create and manage websites — the top-level resource that owns source code,
      content, assets, domains, and analytics.
  - name: Website editors
    description: >-
      Grant, list, and revoke website-scoped editor access, and invite
      collaborators to a single website by email.
  - name: API keys
    description: >-
      Create, scope, rotate, and revoke the API keys that authenticate
      programmatic and agent access.
  - name: Source code
    description: >-
      Read and edit the framework source files of a website draft. Mutations
      require an edit lease.
  - name: Publishing
    description: Validate, build, publish, and roll back website versions.
  - name: CMS collections
    description: >-
      Define the content model: collections of structured content owned by a
      website.
  - name: CMS fields
    description: Manage the typed fields that make up a collection schema.
  - name: CMS items
    description: >-
      Create, query, publish, and organize the content entries inside a
      collection.
  - name: Domains
    description: >-
      Manage platform subdomains and custom domains, including DNS verification
      and the primary domain.
  - name: Assets
    description: Upload and manage website files and images served from the Cactal CDN.
  - name: Media generation
    description: >-
      Generate reference-guided website images that are stored as ordinary
      Cactal CDN assets.
  - name: Web research
    description: >-
      Look at the public web for a website's work: screenshots and measurements
      of external pages, a business's own pages read into profiles, and many
      images at once on numbered contact sheets.
  - name: Project Context
    description: >-
      Upload private durable reference material that the website agent can
      search, read, and inspect.
  - name: Analytics
    description: >-
      Read first-party traffic analytics for a website and export datasets as
      CSV.
  - name: Forms
    description: >-
      Read and triage website form submissions, manage notification recipients,
      and configure per-form settings. Visitors submit to `POST
      /_cactal/forms/{name}` on the website itself.
  - name: Server functions
    description: >-
      Inspect a website's server function runs and run its `http` functions on
      the draft. Visitors call `http` functions with `POST
      /_framework/server/{name}` on the website itself.
  - name: Secrets
    description: >-
      Manage a website's write-only secrets, which its server functions read
      from `env`. Values can be set and deleted but are never returned.
  - name: Organizations
    description: Manage organizations, members, and organization-wide invitations.
  - name: Audit log
    description: >-
      Read the immutable record of actions performed in an organization by users
      and API keys.
  - name: Billing
    description: >-
      Read billing state and manage plans, site capacity, and prepaid usage
      balance. Every billing operation requires the organization owner role,
      which API keys cannot hold — today these operations are performed from the
      dashboard, return 403 for API-key callers, and are hidden from MCP tool
      lists.
paths:
  /skills/{skillId}:
    get:
      tags:
        - Documentation
      summary: Read a Cactal agent skill
      description: >-
        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
      operationId: skills.read
      parameters:
        - name: skillId
          in: path
          required: true
          schema:
            type: string
            enum:
              - 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
            description: Skill to read; the skills it requires come with it.
      responses:
        '200':
          description: The skill and the skills it requires, formatted as Markdown.
          content:
            application/json:
              schema:
                type: object
                properties:
                  content:
                    type: string
                    description: >-
                      The skill and every skill it requires, dependencies first,
                      as Markdown.
                required:
                  - content
                additionalProperties: false
        '400':
          description: >-
            Validation failed. The response `message` names the first invalid
            field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '401':
          description: Missing, invalid, expired, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '403':
          description: The authenticated principal lacks the required capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '404':
          description: >-
            The resource does not exist or is outside the principal’s access
            scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '429':
          description: >-
            Rate limit exceeded. Retry after the number of seconds in the
            `Retry-After` header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
components:
  schemas:
    ServiceError:
      type: object
      required:
        - kind
        - message
      description: >-
        Canonical error body returned by every non-2xx response. Extra fields
        carry error-specific details.
      properties:
        kind:
          type: string
          enum:
            - validation
            - unauthorized
            - forbidden
            - not_found
            - conflict
            - rate_limited
            - internal
          description: Stable, machine-readable error category.
        message:
          type: string
          description: Human-readable explanation of the failure.
        suggestion:
          type: string
          description: >-
            What to do next when the failure has a known fix; may name the exact
            operation to call.
        validValues:
          type: array
          items:
            type: string
          description: The acceptable values for the failing field, when the set is closed.
      additionalProperties: true
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Cactal API key. Create one in the dashboard or via `POST /apiKeys`. The
        plaintext key is shown once at creation.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.