Prompts

Prompts are pre-defined commands or workflows that you can invoke in your editor, typically via a slash command (e.g., /refactor, /review).

Usage

Define prompts in ai.json:

{
   "prompts": {
      "review": {
         "description": "Review the selected code for bugs and style issues.",
         "path": "./prompts/review.md"
      },
      "plan": {
         "description": "Generate a step-by-step implementation plan.",
         "argumentHint": "[feature description]",
         "content": "Create a detailed step-by-step plan to implement: "
      }
   }
}

Editor Support

aix maps these prompts to the native feature in each editor when one exists:

• Cursor: Maps to .cursor/prompts/ (accessible via /).
• Claude Code: Maps to .claude/commands/.
• GitHub Copilot: Project installs map to .github/prompts/*.prompt.md, with native prompt-file frontmatter for name, description, and argument-hint. User-scope installs are converted into Copilot skills under ~/.config/github-copilot/skills/.
• Windsurf: Maps to Cascade commands.
• Codex: Prompts are deprecated and unsupported natively. aix converts them to instruction-only Agent Skills during install.
• Antigravity: Standalone workflows are deprecated upstream; aix converts prompts to instruction-only Agent Skills in .agents/skills/ during install.
• OpenCode: Maps to markdown command files in .opencode/commands/ or ~/.config/opencode/commands/.
• Grok CLI: Prompts are converted to instruction-only Agent Skills in .grok/skills/.
• Zed: Not supported.

Prompt Files

Prompt files are standard markdown. Markdown is preserved as-is.

Example prompts/review.md

Review the selected code for:

1. Logic errors
2. Security vulnerabilities
3. Performance bottlenecks

Provide the output in markdown format with code blocks for suggested fixes.

Arguments

Some prompts take arguments. Use the argumentHint property to explicitly tell the user what to provide.

"refactor": {
  "argumentHint": "[function_name] [pattern]"
}

The content of the prompt will be prefixed to the user’s input.

To install one prompt without creating ai.json, use direct install:

aix install ./prompts/review.md --type prompt --name review --target claude-code --user

Codex and Antigravity conversion

Editors like Codex and Antigravity use Agent Skills for reusable workflows (with Antigravity having deprecated standalone .agents/workflows/ files in favor of skills). When you install an ai.json that contains prompts to Codex or Antigravity, aix converts each prompt into an instruction-only skill and links it into .agents/skills/. The generated skill keeps the prompt content as instructions and includes the prompt description as the skill description.

Name conflicts are resolved in favor of real skills. If skills.review and prompts.review are both present, aix installs the configured skill as review and installs the converted prompt as prompt-review. If that name is already taken, aix adds a numeric suffix.