Commands

Commands are custom slash commands that extend an AI tool’s command palette. They let you define reusable prompts or workflows that users invoke with a slash prefix (e.g., /fix-typo).

Provider Support

Commands are supported by the following providers:

Provider	Format	Notes
Claude Code	Markdown	Command files in .claude/commands/
Gemini CLI	Markdown	Command files in .gemini/commands/
Cursor	Markdown	Command files in .cursor/commands/
Copilot CLI	Markdown	Command files in .copilot/commands/
Codex	Markdown	Command files in .codex/commands/
OpenCode	Markdown	Command files in .opencode/commands/

Canonical Fields

Commands support the following metadata:

Field	Description	Provider Support
effort	Time/complexity: min, moderate, large, max	Claude Code (native); others as behavioral notes

Syllago Format

Commands are stored in your library using syllago’s provider-neutral format. The metadata file (.syllago.yaml) describes the content, and a separate source file holds the command definition.

Catalog Entry

id: 6c0ce509-7960-490f-9100-4d5009d6261c
name: fix_typo
type: commands
source_format: toml
source_type: provider
has_source: true
added_at: 2026-03-11T19:23:53Z
added_by: syllago

Key fields:

• type — always commands for this content type
• source_format — the format of the source file (toml, md, yaml)
• has_source — indicates the item includes a source file with the command definition

Command Source

The source file contains the actual command definition. The format depends on where the command was imported from. Here is a TOML example (Codex-style):

description = "Fix a typo in a document."

[variables]
file_path = "{{FILE_PATH}}"
file_content = "{{FILE_CONTENT}}"

[instructions]
preamble = "You are a documentation editor..."
steps = [
    "Read the file content carefully.",
    "Find and fix the reported typo.",
]

A Markdown-based command (Claude Code or Gemini CLI style) would instead be a .md file with the prompt content directly as prose, optionally with frontmatter for metadata.

Format Conversion

When you export a command to a provider, syllago converts between formats automatically. See Format Conversion for details on how syllago handles cross-format translation.

Working with Commands

# Add a command from a provider
syllago add commands/fix-typo --from claude-code

# List commands in your library
syllago list --type commands

# Install a command to a different provider
syllago install fix_typo --to gemini-cli

# Inspect a command's metadata and source
syllago inspect fix_typo

See Also

• Content Types Overview — compatibility matrix and all content types
• Format Conversion — how syllago converts between provider formats