Overview

The gizzi skills command manages the agents and skills available to the Allternit runtime. It can create new agents from a description, list all registered agents, and generate new skills with AI assistance. Use it to:
  • Bootstrap agents for specific workflows or code-review roles
  • Inspect the agents currently available to Gizzi Code
  • Generate reusable skills from a plain-language description

Command reference

gizzi skills requires a subcommand. Run gizzi skills --help to see the available options.

Agent modes

When creating an agent with gizzi skills create, choose how the agent can be used:

Available tools

Agents created with gizzi skills create can be granted access to a subset of the runtime tool belt. Pass a comma-separated list to --tools:
  • bash — shell command execution
  • read — read files
  • write — write files
  • edit — edit files
  • list — list directories
  • glob — file globbing
  • grep — search file contents
  • webfetch — fetch web pages
  • task — spawn subagent tasks
  • todowrite — write todo lists
  • todoread — read todo lists
Omit --tools entirely to enable every tool.

Usage examples

List agents

Create an agent interactively

Create an agent non-interactively

Create an agent in a custom directory

Generate a skill

Generate a skill in a specific directory

Where agents and skills are stored

  • Agents created without --path are written to .gizzi/agent/ in the current project, or to the global Gizzi Code config directory when global scope is selected interactively.
  • Skills created without --path are written to ./.gizzi/skills/.

Common flags

gizzi skills create

gizzi skills create-skill

Global options