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

Clone the repository

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

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

Open in your IDE with Claude Code

# VS Code with Claude extension
code .

# Or use Claude Code CLI
claude

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
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

Automatic Discovery: Skills are loaded when you open the project
Context-Based Activation: Claude reads your request and activates the appropriate skill
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]

Create a Simple Indicator

You: "Create a moving average crossover indicator"
Claude: [pine-developer creates the indicator with proper inputs and alerts]

Build a Complex Strategy

You: "Build a strategy that combines RSI, MACD, and volume analysis with proper risk management"
Claude: [pine-manager coordinates multiple skills for complete implementation]

Debug Existing Code

You: "My script is repainting, help me fix it"
Claude: [pine-debugger identifies and fixes repainting issues]

Optimize Performance

You: "Make my script load faster"
Claude: [pine-optimizer improves calculation efficiency]

Prepare for Publishing

You: "Prepare my script for TradingView publication"
Claude: [pine-publisher adds documentation and ensures compliance]

📚 Available Templates

Indicators

RSI Divergence — RSI with bullish/bearish divergence detection
Multi-Timeframe — Multi-timeframe analysis indicator
Support & Resistance — Key level identification
VWAP Bands — VWAP with standard deviation bands
RSI Basic — Simple RSI momentum indicator

Strategies

Breakout — Range breakout entry system
Mean Reversion — Oversold/overbought reversal system
Momentum — Momentum-based entry strategy
MA Cross — Moving average crossover strategy

Utilities

Debug Panel — Label and table debugging tools
Risk Manager — Position sizing and stop losses
Session Filter — Trading session time filters

🗣️ Natural Language Interface

No need for complex commands! Just talk to Claude naturally:

Simple words trigger actions: Type start, help, status, examples
Describe what you want: "Create a strategy that buys on RSI oversold"
Share videos: "Analyze this YouTube video: [URL]"
Ask for help: "What can you do?" or "Show me examples"

Skills activate automatically based on what you're trying to accomplish.

🎯 Key Features

Pine Script v6 Support: Full compatibility with latest Pine Script version
Intelligent Workflow: Automatic skill activation based on task context
Template Library: Pre-built components for rapid development
Debug Tools: Built-in debugging capabilities
Performance Metrics: Comprehensive backtesting statistics
Publication Ready: Scripts prepared for TradingView community
File Protection: Lock system files while developing in /projects/

🛠️ Development Workflow

Describe Your Idea: Tell Claude what you want to create
Automatic Planning: Skills break down requirements
Implementation: Code is written following best practices
Testing: Debug tools and backtesting added
Optimization: Performance and UX enhanced
Delivery: Complete, production-ready script

📋 Best Practices

Always test scripts on multiple timeframes
Include proper error handling
Add tooltips to all inputs
Document complex logic
Avoid repainting issues
Optimize for performance
Follow TradingView guidelines

🚨 Common Commands

Command	What Happens
`"Create indicator"`	pine-developer activates for implementation
`"Create strategy"`	pine-developer activates with strategy focus
`"Debug my script"`	pine-debugger activates for troubleshooting
`"Add backtesting"`	pine-backtester adds performance metrics
`"Optimize performance"`	pine-optimizer improves efficiency
`"Prepare for publishing"`	pine-publisher adds documentation
`"Build complete system"`	pine-manager orchestrates full workflow

📖 Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch
Add new templates or improve skills
Submit a pull request

📄 License

MIT License - feel free to use this project for any purpose.

🙏 Acknowledgments

Built for use with Claude Code
Powered by Claude Code's Skills system
Designed for TradingView Pine Script v6
Community contributions and feedback

💬 Support

For issues, questions, or suggestions:

Open an issue on GitHub
Check existing documentation
Review example scripts

Ready to create professional Pine Scripts? Open this project in Claude Code and start building!

pine-debugger