pinescript-agents
Claude Code toolset for developing TradingView pine scripts.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/traderspost--pinescript-agents)HTML
<a href="/listings/traderspost--pinescript-agents"><img src="/api/listings/traderspost--pinescript-agents/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 273 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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**
- ```bash
- git clone https://github.com/TradersPost/pinescript-agents.git
- cd pinescript-agents
- ```
- 2. **Install dependencies** (for YouTube video analysis)
- ```bash
- 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**
- ```bash
- # 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]
- ```
- ### 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
- 1. **Describe Your Idea**: Tell Claude what you want to create
- 2. **Automatic Planning**: Skills break down requirements
- 3. **Implementation**: Code is written following best practices
- 4. **Testing**: Debug tools and backtesting added
- 5. **Optimization**: Performance and UX enhanced
- 6. **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
- - [Pine Script v6 Reference](docs/manual/pinescriptv6_complete_reference.md)
- - [User Guide](docs/docs/index.md)
- - [Skill Documentation](.claude/skills/)
- - [Changelog](CHANGELOG.md)
- ## 🤝 Contributing
- Contributions are welcome! Please feel free to submit a Pull Request.
- 1. Fork the repository
- 2. Create your feature branch
- 3. Add new templates or improve skills
- 4. Submit a pull request
- ## 📄 License
- MIT License - feel free to use this project for any purpose.
- ## 🙏 Acknowledgments
- - Built for use with [Claude Code](https://claude.ai/code)
- - Powered by Claude Code's Skills system
- - Designed for [TradingView](https://www.tradingview.com) 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!
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.