pinescript

Pine Script Development Assistant for Claude Code

A comprehensive Pine Script development environment powered by Claude Code's Skills system. This tool helps you create professional TradingView indicators and strategies with AI assistance.

Just type start to begin!

🚀 Quick Start

1. Clone the repository

   git clone https://github.com/TradersPost/pinescript-agents.git
   cd pinescript-agents
   

2. Install dependencies (for YouTube video analysis)

   pip install -r requirements.txt
   
   # Also need FFmpeg for audio processing (optional, for Whisper fallback)
   # macOS: brew install ffmpeg
   # Ubuntu: sudo apt install ffmpeg
   

3. Open in your IDE with Claude Code

   # VS Code with Claude extension
   code .
   
   # Or use Claude Code CLI
   claude
   

4. Just type "start" in Claude chat

   start
   

   This launches an interactive guide that helps you:

   • Create custom scripts
   • Analyze YouTube videos
   • Choose from templates
   • Understand system capabilities

5. Or jump straight to creating

   Create an RSI divergence indicator with alerts
   Build a mean reversion strategy using Bollinger Bands
   Analyze this video: https://youtube.com/watch?v=...
   

   Other helpful commands:

   • help - Show all available commands
   • examples - List example scripts
   • templates - Show quick templates
   • status - Show system status and available skills

🎯 Specialized AI Skills

This project uses Claude Code's Skills system - specialized capabilities that automatically activate based on your request. No explicit commands needed!

How Skills Work

1. Automatic Discovery: Skills are loaded when you open the project
2. Context-Based Activation: Claude reads your request and activates the appropriate skill
3. Seamless Integration: Skills feel like natural capabilities, not separate tools

Available Skills

Skill	Activates When You...	What It Does
📊 pine-visualizer	Ask conceptual questions, share YouTube videos, say "how would I build"	Breaks down trading ideas into implementable components
💻 pine-developer	Say "create", "write", "implement", "code"	Writes production-quality Pine Script v6 code
🐛 pine-debugger	Say "debug", "fix", "error", "not working"	Adds debugging tools and troubleshoots issues
📈 pine-backtester	Say "backtest", "metrics", "win rate", "performance"	Implements comprehensive testing capabilities
⚡ pine-optimizer	Say "optimize", "faster", "improve", "better UX"	Enhances performance and user experience
🎯 pine-manager	Have complex multi-part requests, say "complete trading system"	Orchestrates complex multi-step development
📝 pine-publisher	Say "publish", "release", "documentation"	Prepares scripts for TradingView publication

Skill Activation Examples

You: "Create an RSI indicator"
→ pine-developer skill activates automatically

You: "My script has errors"
→ pine-debugger skill activates automatically

You: "How would I build a mean reversion strategy?"
→ pine-visualizer skill activates automatically

You: "Build a complete trading system with backtesting"
→ pine-manager skill orchestrates multiple skills

📁 Project Structure

pinescript-agents/
├── .claude/
│   ├── skills/          # AI skill configurations (SKILL.md files)
│   ├── commands/         # Slash commands (start, create, video, etc.)
│   └── hooks/            # System hooks for commands
├── docs/
│   ├── docs/             # User guide (concepts, language, FAQ, errors)
│   ├── manual/           # Complete Pine Script v6 reference
│   └── server/           # MCP documentation server
├── templates/            # Ready-to-use templates
│   ├── indicators/       # Indicator templates
│   ├── strategies/       # Strategy templates
│   └── utilities/        # Helper functions
├── projects/             # Your Pine Script projects
├── examples/             # Example scripts
├── tools/                # Utility scripts
├── CLAUDE.md             # Claude Code instructions
└── CHANGELOG.md          # Version history

💡 Usage Examples

Quick Commands

Just type these single words in Claude chat:

• start - Launch interactive setup guide
• help - Show available commands
• status - Show system status and available skills
• examples - List all example scripts
• templates - Show quick templates
• lock - Protect system files (only /projects/ writable)
• unlock - Allow all file modifications

Analyze a YouTube Video

You: Analyze this video: https://youtube.com/watch?v=...
Claude: [pine-visualizer extracts transcript, identifies components, creates specification]