Skill API

The Skill API defines how to build extensions that add new tools, integrations, and workflows to Aigentic agents. This reference covers skill creation using both SkillForge and manual methods.

SkillForge (AI-Powered Creation)

The fastest way to create a skill is through SkillForge, which generates complete skill packages from plain English:

1. Open Skills from the sidebar and go to the Create tab.
2. Describe what you want:

   A skill that fetches the current weather for any city
   using the OpenWeatherMap API

3. SkillForge generates the complete skill package.
4. Review and install.

SkillForge handles tool definitions, parameter schemas, and implementation logic automatically.

SKILL.md Format

Skills are defined using a SKILL.md file with YAML frontmatter.

Basic Structure

---
name: weather-lookup
description: Fetches current weather data for any city
allowed-tools:
  - web_search
metadata:
  author: your-username
  version: 1.0.0
---

# Weather Lookup

This skill provides weather data for any city using the OpenWeatherMap API.

## Tools

### get_weather
Fetches the current weather for a specified city.

**Parameters:**
- `city` (string, required) — The city name
- `units` (string, optional) — "metric" or "imperial", defaults to "metric"

**Returns:** Temperature, conditions, humidity, and wind speed.

## Usage

Use this skill when the user asks about current weather conditions
for a specific location.

Frontmatter Fields

Field	Required	Description
name	Yes	Unique identifier (lowercase, hyphens allowed)
description	Yes	Brief description shown in the UI
allowed-tools	No	Built-in tools the skill requires
metadata	No	Additional metadata
metadata.author	No	Skill author
metadata.version	No	Version string

Tool Definitions

Skills can define new tools using JSON Schema for input parameters:

{
  "name": "search_github_repos",
  "displayName": "Search GitHub Repositories",
  "description": "Search GitHub repositories by query and language. Use when the user wants to find repositories.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search query"
      },
      "language": {
        "type": "string",
        "description": "Filter by programming language"
      },
      "limit": {
        "type": "integer",
        "description": "Number of results (1-30)",
        "minimum": 1,
        "maximum": 30,
        "default": 10
      }
    },
    "required": ["query"]
  }
}

Writing Good Tool Descriptions

The description field tells the AI model when and how to use the tool. A good description includes:

• What the tool does
• When to use it (trigger conditions)
• What it returns

Supported Input Types

JSON Schema Type	Description
string	Text value
integer	Whole number
number	Decimal number
boolean	True/false
array	Ordered list
object	Key-value map

Credential Management

Skills that access external services can declare required credentials:

---
name: github-integration
description: GitHub repository management
metadata:
  credentials:
    - key: GITHUB_TOKEN
      label: GitHub Personal Access Token
      description: Token with repo scope
      required: true
---

Credentials are stored in the encrypted vault and injected at runtime.

Installing Skills

Browse and install skills from the ClawHub catalog on the Skills page. After installing, an agent assignment dialog lets you select which agents should use the skill. You can also assign skills later from the agent’s profile dialog (Skills tab).

Complete Example

Here is a complete skill that searches for news articles:

SKILL.md

---
name: news-search
description: Search for recent news articles on any topic
allowed-tools:
  - web_search
metadata:
  author: example-user
  version: 1.0.0
---

# News Search

Search for and summarize recent news articles on any topic.

## Tools

### search_news
Searches for recent news articles matching a query.

**Parameters:**
- `topic` (string, required) — The news topic to search for
- `count` (integer, optional) — Number of articles to return (default: 5)

**Returns:** List of articles with title, source, date, and summary.

## Usage

When a user asks about recent news, current events, or wants to know
what is happening with a particular topic, use the search_news tool
to find relevant articles and summarize the results.

Testing

Install the skill, attach it to a test agent, and try:

User: What is the latest news about AI regulation in the EU?

Agent: [invokes search_news with topic="AI regulation EU"]

Here are the latest developments in EU AI regulation:

1. **EU AI Act Implementation Update** - ...
2. **New Guidelines Released** - ...
...

Publishing

Once your skill is tested:

1. Ensure metadata is complete.
2. Include clear usage instructions.
3. Submit through the skills section.

Published skills are reviewed and appear in the skills directory.