Factory Droid — Commands
- File format
- Markdown
- Discovery path
-
.factory/commands - Global install path
-
~/.factory/commands - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Provider field | Conversion | Canonical key | Summary |
|---|---|---|---|
$ARGUMENTS | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | argument_substitution | $ARGUMENTS substitution in Markdown-type commands expands to text typed after the command name; argument-hint frontmatter field provides autocomplete usage hint; executable commands receive arguments as positional shell parameters |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
| Command Discovery Paths | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Commands discovered from .factory/commands/ (workspace/project, shared with teammates) or ~/.factory/commands/ (personal, cross-project). Only Markdown files and scripts with shebangs register. Filenames become lowercase slugs (spaces become hyphens), so 'Code Review.mdx' becomes /code-review. |
| Two Command Types | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Commands are either Markdown templates (with $ARGUMENTS substitution and optional YAML frontmatter for description and argument-hint) or Executable scripts (must have shebang line, receive args as positional params, stdout up to 64 KB posted back to chat along with script contents). |
| Commands UI Hot Reload | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | /commands UI supports pressing R to reload commands from disk without restarting the session; includes an import feature to convert existing .agents or .claude commands into Factory format. |
| Skills Supersede Commands | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Factory's docs recommend skills over commands for new work; commands remain supported only for backwards compatibility. |
Sources
| Source |
|---|
| https://docs.factory.ai/cli/configuration/custom-slash-commands |