List Skills

Get enabled skills for the project.

GET /v1/skills

cURL

curl -X GET https://api.astralform.ai/v1/skills \
  -H "X-API-Key: sk_live_your_api_key"

200

[
  {
    "name": "pdf-processing",
    "display_name": "PDF Processing",
    "description": "Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs.",
    "version": "1.0.0",
    "author": "Astralform"
  },
  {
    "name": "data-analysis",
    "display_name": "Data Analysis",
    "description": "Analyzes datasets, generates charts, and creates summary reports.",
    "version": "2.1.0",
    "author": null
  }
]

Returns metadata for all enabled skills configured for this project. The agent uses this to know which skills are available.

Authentication

X-API-Key · string · required

Project API key (e.g., sk_live_... or sk_test_...)

Response

skills · array

Array of skill objects

Show Skill object

name · string

Skill identifier (from SKILL.md frontmatter)

display_name · string

Human-readable name (optional)

description · string

Short description shown to agent

version · string

Skill version (optional)

author · string

Skill author (optional)

cURL

curl -X GET https://api.astralform.ai/v1/skills \
  -H "X-API-Key: sk_live_your_api_key"

200

[
  {
    "name": "pdf-processing",
    "display_name": "PDF Processing",
    "description": "Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs.",
    "version": "1.0.0",
    "author": "Astralform"
  },
  {
    "name": "data-analysis",
    "display_name": "Data Analysis",
    "description": "Analyzes datasets, generates charts, and creates summary reports.",
    "version": "2.1.0",
    "author": null
  }
]

Usage Notes

• Only enabled skills are returned
• Descriptions are kept short (~100 tokens) for efficient context usage
• The agent automatically activates skills when user requests match
• Full skill content is loaded only when activated (progressive disclosure)