Skip to main content

Formats

PRPM supports multiple AI tool formats, allowing you to install packages for different IDEs and development environments.

Supported Formats

FormatToolDescription
claudeClaude CodeAgents and skills for Claude Code
cursorCursor IDERules and configurations for Cursor
continueContinue.devPrompts for Continue extension
windsurfWindsurf IDERules for Windsurf
copilotGitHub CopilotInstructions, chat modes, and skills for Copilot
kiroKiro AIAgents and steering files for Kiro
geminiGemini CLICustom commands and extensions for Gemini CLI
opencodeOpenCode AIAgents, commands, and tools for OpenCode
rulerRulerCoding rules and agents for Ruler
droidFactory DroidSkills, commands, and hooks for Factory Droid
traeTrae IDERules for Trae IDE (ByteDance)
aiderAiderConventions and rules for Aider AI coding assistant
zencoderZencoderRules for Zencoder AI coding assistant
replitReplit AgentInstructions for Replit Agent
agents.mdAgents.mdUniversal agent format (works with OpenAI, Gemini, etc.)
mcpModel Context ProtocolMCP server configurations
genericMultipleWorks across multiple tools

Format Aliases

Some formats have aliases for compatibility:
  • claude.mdclaude
  • gemini.md → installs GEMINI.md (Gemini markdown); gemini installs Gemini CLI commands into .gemini/commands

Copilot Format Details

The copilot format supports three subtypes:
  • Rules (subtype: rule): Path-specific instructions in .github/instructions/*.instructions.md
  • Chat Modes (subtype: chatmode): Custom chat modes in .github/chatmodes/*.chatmode.md
  • Skills (subtype: skill): Reusable task-specific capabilities in .github/skills/<name>/SKILL.md
Skills are discovered by Copilot based on context and loaded when relevant. Each skill requires:
  • A name field (lowercase, hyphens for spaces, max 64 chars)
  • A description field (max 1024 chars)
  • Markdown body with detailed instructions
Skills require VS Code Insiders with the chat.useAgentSkills setting enabled.

Gemini Format Details

The gemini format supports two subtypes:
  • Slash Commands (subtype: slash-command): Custom commands defined in .toml files, installed to .gemini/commands/
  • Extensions (subtype: extension): Full extensions with MCP servers and context files, installed to .gemini/extensions/<name>/gemini-extension.json
Extensions support:
  • MCP (Model Context Protocol) server configurations
  • Custom context files
  • Tool exclusions
  • Experimental settings

Installing for Specific Formats

Auto-detect format from your project:
prpm install @prpm/@username/typescript-best-practices
Specify a format explicitly:
prpm install @prpm/@username/typescript-best-practices --as cursor

Format Detection

PRPM auto-detects the format based on your project structure:
  • .claude/ directory → claude
  • .cursor/ directory → cursor
  • .continue/ directory → continue
  • .windsurf/ directory → windsurf
  • .kiro/ directory → kiro
  • .agents/ directory → agents.md
  • .ruler/ directory → ruler
  • .opencode/ directory → opencode
  • .factory/ directory → droid
  • .trae/ directory → trae
  • .aider/ or CONVENTIONS.md file → aider
  • .zencoder/ directory → zencoder
  • .replit/ directory or .replit file → replit
  • .mcp/ directory → mcp

File Installation Paths

Each format has a standard installation path:
FormatDirectoryExample
claude.claude/agents/, .claude/skills/, or .claude/commands/.claude/skills/my-skill/SKILL.md
cursor.cursor/rules/.cursor/rules/typescript.mdc
continue.continue/prompts/.continue/prompts/refactor.md
windsurf.windsurf/rules/.windsurf/rules/python.md
copilot.github/instructions/, .github/chatmodes/, or .github/skills/.github/skills/my-skill/SKILL.md
kiro.kiro/agents/ or .kiro/steering/.kiro/agents/code-reviewer.json
gemini.gemini/commands/ or .gemini/extensions/.gemini/commands/refactor.toml or .gemini/extensions/my-ext/gemini-extension.json
opencode.opencode/agent/ or .opencode/command/.opencode/agent/code-reviewer.md
ruler.ruler/rules/ or .ruler/agents/.ruler/rules/typescript.md
droid.factory/skills/ or .factory/commands/.factory/skills/code-review/SKILL.md
trae.trae/rules/.trae/rules/typescript.md
aiderCONVENTIONS.md or .aider/CONVENTIONS.md
zencoder.zencoder/rules/.zencoder/rules/typescript.md
replit.replit/ or replit_agent_instructions.mdreplit_agent_instructions.md
agents.md.agents/.agents/code-reviewer.md
mcp.mcp/servers/.mcp/servers/filesystem.json

Multi-Format Packages

Some packages support multiple formats. PRPM will install the appropriate version based on your environment:
{
  "name": "@username/typescript-rules",
  "version": "1.0.0",
  "files": [
    {
      "path": ".cursor/rules/typescript.mdc",
      "format": "cursor"
    },
    {
      "path": ".windsurf/rules/typescript.md",
      "format": "windsurf"
    }
  ]
}

Next Steps