skill-creator

Skill Creator

Create skill packages that extend the agent with new knowledge and tools.

Package Structure

A skill package is a directory with at least a SKILL.md file:

my-skill/
  SKILL.md            # Required: agent instructions + frontmatter
  manifest.json       # Optional: declares tool executables
  Cargo.toml          # Optional: Rust crate (if tool is written in Rust)
  src/main.rs         # Optional: tool source code
  package.json        # Optional: Node.js dependencies
  scripts/            # Optional: helper scripts
  references/         # Optional: reference docs

SKILL.md Format

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
author: your-name
always: false
requires_bins: docker,kubectl
requires_env: GITHUB_TOKEN
---

# Skill Title

Instructions for the agent on how to use this skill.
Include examples, tool usage patterns, and best practices.

Frontmatter Fields

Field	Required	Description
name	Yes	Skill identifier (lowercase, hyphens)
description	Yes	One-line description (shown in skill index)
version	No	Semver version (e.g. 1.0.0)
author	No	Author name or org
always	No	true to auto-load in every prompt (default: false)
requires_bins	No	Comma-separated binaries that must be on PATH
requires_env	No	Comma-separated env vars that must be set

Adding Tools

To provide executable tools that the agent can call, add a manifest.json:

{
  "name": "my-skill",
  "version": "1.0.0",
  "tools": [
    {
      "name": "my_tool",
      "description": "What this tool does (shown to the LLM)",
      "input_schema": {
        "type": "object",
        "properties": {
          "query": {"type": "string", "description": "Search query"},
          "limit": {"type": "integer", "description": "Max results", "default": 10}
        },
        "required": ["query"]
      }
    }
  ]
}