Skip to main content

Get Skills

curl -X GET https://api.asta.app/api/settings/skills \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "skills": [
    {
      "id": "files",
      "name": "Files",
      "description": "Local file access and summaries",
      "enabled": true,
      "available": true,
      "source": "builtin",
      "is_agent": false
    },
    {
      "id": "google_search",
      "name": "Google search",
      "description": "Search the web for current information",
      "enabled": true,
      "available": true,
      "source": "builtin",
      "is_agent": false
    },
    {
      "id": "spotify",
      "name": "Spotify",
      "description": "Search songs on Spotify",
      "enabled": true,
      "available": true,
      "source": "builtin",
      "is_agent": false,
      "action_hint": "Connect"
    },
    {
      "id": "github",
      "name": "GitHub",
      "description": "Manage repos, issues, pull requests",
      "enabled": true,
      "available": true,
      "source": "builtin",
      "is_agent": false,
      "required_bins": ["gh"],
      "install_cmd": "brew install gh",
      "install_label": "Install GitHub CLI"
    }
  ]
}
skills
array
List of available skills

Toggle Skill

curl -X PUT https://api.asta.app/api/settings/skills \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "skill_id": "spotify",
    "enabled": true
  }'
skill_id
string
required
Skill identifier to toggle
enabled
boolean
required
Enable or disable the skill
{
  "skill_id": "spotify",
  "enabled": true
}
skill_id
string
The skill that was toggled
enabled
boolean
New enabled state

Built-in Skills

Asta includes the following built-in skills:

Core Skills

  • Files - Local file access and summaries
  • RAG - Learning and document knowledge
  • Time - Current time with timezone support
  • Weather - Current weather and forecasts

Search & Information

  • Google Search - Web search for current information
  • Lyrics - Find song lyrics

Integrations

  • Spotify - Search and play music
  • GitHub - Manage repos, issues, and PRs (requires gh CLI)
  • Vercel - Check deployments and projects (requires vercel CLI)
  • Google Workspace - Gmail, Calendar, Drive, Contacts (requires gog CLI)

Productivity

  • Reminders - Wake-up calls and scheduled reminders
  • Audio Notes - Transcribe and format meeting recordings
  • Self Awareness - Answer questions about Asta itself
  • Server Status - Monitor system metrics

Fun

  • Silly GIF - Reply with relevant GIFs (requires Giphy API key)

Upload Skill Package

curl -X POST https://api.asta.app/api/skills/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "[email protected]"
file
file
required
Zip file containing skill with SKILL.md at root or in single top-level folder
{
  "skill_id": "my-custom-skill",
  "ok": true
}
skill_id
string
ID of the uploaded skill
ok
boolean
Whether upload was successful
Skill packages must follow the OpenClaw format with a SKILL.md file at the root. Max file size: 20 MB.

Build docs developers (and LLMs) love