Skip to main content

1. Scaffold

mkdir my-skill && cd my-skill
theo skill init
This creates theo-skill.json and README.md.

2. Define the Manifest

Edit theo-skill.json or use defineSkill() in TypeScript:
import { defineSkill } from "@hitheo/sdk";

export default defineSkill({
  name: "Inventory Check",
  slug: "inventory-check",
  version: "1.0.0",
  description: "Real-time inventory lookup and reorder alerts",
  category: "automation",
  author: { name: "Acme Corp" },
  systemPromptExtension: `
    You are an inventory management specialist. When the user asks about
    stock levels, use the check_stock tool. Flag items below reorder threshold.
  `,
  tools: [
    {
      name: "check_stock",
      description: "Look up current stock levels for a SKU",
      inputSchema: {
        type: "object",
        properties: {
          sku: { type: "string", description: "Product SKU" },
        },
        required: ["sku"],
      },
    },
  ],
  permissions: ["read:artifacts", "execute:tools"],
  trigger: { type: "keyword", config: { keywords: ["stock", "inventory", "reorder"] } },
});

3. Validate

theo skill validate

4. Publish

theo skill publish
See Publishing and Review Pipeline for details.