Skills Overview

import { Agent, loadSkill, openai } from "@agentium/core";

const agent = new Agent({
  name: "assistant",
  model: openai(process.env.OPENAI_MODEL ?? "gpt-6.1-sol"),
  skills: [
    "./skills/shipping",           // local directory
    "@agentium/skill-crm",         // npm package
    "https://skills.example.com/analytics", // remote URL
  ],
});

skills/shipping/
  skill.json
  tools.ts
  instructions.md

// skill.json
{
  "name": "shipping",
  "description": "Shipping rate calculation and tracking",
  "version": "1.0.0",
  "main": "tools.ts",
  "instructions": "instructions.md"
}

// tools.ts
import { defineTool } from "@agentium/core";
import { z } from "zod";

export function getTools() {
  return [
    defineTool({
      name: "calculate_shipping_rate",
      description: "Calculate shipping cost",
      parameters: z.object({
        weight: z.number(),
        destination: z.string(),
      }),
      execute: async (args) => {
        // calculation logic
        return `$${(args.weight * 0.5).toFixed(2)}`;
      },
    }),
  ];
}

skills: ["@agentium/skill-crm"]

skills: ["https://skills.example.com/analytics"]

import type { Skill } from "@agentium/core";

const mySkill: Skill = {
  name: "custom",
  description: "Custom skill",
  version: "1.0.0",
  tools: [/* ToolDef[] */],
  instructions: "Use these tools when...",
};

new Agent({ model, skills: [mySkill] });

[Skill: shipping]
Use the calculate_shipping_rate tool when the user asks about shipping costs.
Always ask for weight and destination before calculating.