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: `low`, `medium`, `high`, `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: md
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 (md for all supported providers)
has_source — indicates the item includes a source file with the command definition

Command source

The source file is a Markdown file with optional YAML frontmatter for metadata. Here is a Claude Code-style example:

---
description: Fix a typo in a document.
argument-hint: <file-path>
---

You are a documentation editor.

1. Read the file at $ARGUMENTS carefully.
2. Find and fix the reported typo.
3. Report back what you changed.

All supported providers (Claude Code, Gemini CLI, Cursor, Copilot CLI, Codex, OpenCode, and others) use this Markdown-with-frontmatter convention. Frontmatter fields differ slightly per provider — see the per-provider commands pages under Providers.

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