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.md → claude
  • 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

​
MCP Format Details

The mcp format is for MCP (Model Context Protocol) server packages. Use subtype: tool. When installed, PRPM reads the mcpServers object from your package’s JSON file and merges each server entry into the user’s editor config. This works across 11 editors — Claude Code, Cursor, VS Code, Codex, Windsurf, Gemini, Kiro, OpenCode, Trae, Amp, and Zed. Your package file should be a JSON file with a mcpServers object:
mcp-server.json
{
  "name": "My MCP Server",
  "description": "What this server does",
  "version": "1.0.0",
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"]
    }
  }
}
See the MCP Servers guide for full publishing and installation details.

​
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

Packages

Learn more about packages

Publishing Guide

Publish multi-format packages