Skills

Install PromptRails skills for AI coding assistants like Claude Code, Cursor, and Windsurf to get contextual help with SDKs, CLI, and platform features.

Skills

PromptRails provides skills for AI coding assistants — pre-built knowledge packages that teach tools like Claude Code, Cursor, and Windsurf how to work with PromptRails SDKs, CLI, agents, prompts, tracing, and more.

When a skill is installed, your AI assistant automatically knows how to:

• Use Python, JavaScript, and Go SDKs correctly
• Run CLI commands for agent management
• Create and configure agents, prompts, and data sources
• Debug executions using tracing
• Set up MCP tools and guardrails
• Follow PromptRails best practices

Installation

Cursor

Use the plugin system to install the PromptRails skill:

/add-plugin promptrails/skills

Skills CLI

Install using the npx skills command:

npx skills add promptrails/skills --skill "promptrails"

Claude Code

Add the skill path to your project's .claude/settings.json:

{
  "skills": ["path/to/skills/skills/promptrails/SKILL.md"]
}

Or clone the repository and symlink it into your Claude Code skills directory.

Manual Setup

Clone the skills repository and point your AI assistant's configuration to the skills/promptrails/SKILL.md file:

git clone https://github.com/promptrails/skills.git promptrails-skills

What's Included

The skill package includes a main skill definition and detailed reference guides:

How It Works

Skills use a progressive disclosure approach:

1. The main skill file (SKILL.md) contains essential patterns and quick-start examples
2. Reference files provide detailed API documentation loaded only when needed
3. Your AI assistant uses the skill context to generate accurate, idiomatic code

This means the assistant won't hallucinate API methods or use outdated patterns — it has the actual SDK reference available.

Example Usage

Once installed, you can ask your AI assistant things like:

• "Execute my customer support agent with the Python SDK"
• "Set up a chain agent with two prompts"
• "Show me how to filter traces by LLM span kind"
• "Create a webhook trigger for my agent using the CLI"
• "Add a PII guardrail to my agent"

The assistant will use the skill's reference materials to provide accurate, working code.

Updating

To get the latest skill definitions, update your installation:

# Skills CLI
npx skills update promptrails/skills
 
# Manual
cd promptrails-skills && git pull

Source Code

The skills are open source and available on GitHub:

• github.com/promptrails/skills

Related Topics

• Python SDK -- Full Python SDK documentation
• JavaScript SDK -- Full JavaScript/TypeScript SDK documentation
• Go SDK -- Full Go SDK documentation
• CLI -- CLI reference
• MCP Server -- PromptRails as an MCP server for IDEs