pine-script

name: pine-script description: Convert Python backtest strategies to TradingView Pine Script v6, or generate Pine Script from natural language descriptions. category: tool

Overview

This skill enables two workflows:

1. Export: convert an existing signal_engine.py (from a completed backtest run) into a TradingView Pine Script v6 strategy
2. Generate: write Pine Script v6 directly from a natural-language strategy description

Output file: artifacts/strategy.pine (inside the run directory, or a new run directory).

Workflow: Export from Backtest

1. load_skill("pine-script") — read this conversion guide
2. read_file("config.json") — understand instruments, dates, parameters
3. read_file("code/signal_engine.py") — understand the Python strategy logic
4. Translate the strategy to Pine Script v6 using the mapping table below
5. write_file("artifacts/strategy.pine") — save the output
6. Return the Pine Script in a code block with usage instructions

Workflow: Generate from Description

1. load_skill("pine-script") — read this guide
2. Write Pine Script v6 directly based on the user's description
3. write_file("artifacts/strategy.pine") — save the output
4. Return the code with usage instructions

Pine Script v6 Strategy Template

// This strategy was generated by Vibe-Trading
// Paste into TradingView Pine Editor → Add to Chart
//@version=6
strategy("Strategy Name", overlay=true, default_qty_type=strategy.percent_of_equity, default_qty_value=100, commission_type=strategy.commission.percent, commission_value=0.1, initial_capital=1000000)

// ============================================================================
// INPUTS
// ============================================================================
// [Group inputs logically with input.int(), input.float(), input.string()]

// ============================================================================
// CALCULATIONS
// ============================================================================
// [Core indicator calculations]

// ============================================================================
// CONDITIONS
// ============================================================================
longCondition = false
shortCondition = false
exitLongCondition = false
exitShortCondition = false

// ============================================================================
// STRATEGY EXECUTION
// ============================================================================
if longCondition
    strategy.entry("Long", strategy.long)
if shortCondition
    strategy.entry("Short", strategy.short)
if exitLongCondition
    strategy.close("Long")
if exitShortCondition
    strategy.close("Short")

// ============================================================================
// PLOTS
// ============================================================================
// [Visual overlays: moving averages, bands, signals]

// ============================================================================
// ALERTS
// ============================================================================
alertcondition(longCondition, title="Long Signal", message="Long entry signal triggered")
alertcondition(shortCondition, title="Short Signal", message="Short entry signal triggered")

Python → Pine Script Mapping Table

Technical Indicators

Data References

Signal Logic

Position Sizing

Pine Script v6 Syntax Rules

Critical Rules (common errors)

1. Version declaration must be first line: //@version=6
2. Ternary operators MUST stay on one line or use intermediate variables:

   // WRONG — causes "end of line without line continuation"
   text = condition ? "value1" :
          "value2"
   
   // CORRECT
   text = condition ? "value1" : "value2"
   

3. Line continuation: continuation lines must be indented MORE than the starting line
4. No plot() in local scope (if/for/function):

   // WRONG
   if condition
       plot(value)
   
   // CORRECT
   plot(condition ? value : na)
   

5. var vs regular variables: use var for persistent state across bars, regular assignment recalculates each bar
6. varip: persistent even on real-time bar updates (intrabar persistence)

Script Types

Default output: strategy (matches Vibe-Trading's backtest-first philosophy).

Avoid Repainting

• Use barstate.isconfirmed for signals on confirmed bars only
• Use request.security() with lookahead=barmerge.lookahead_off (default in v6)
• Do NOT use security() on lower timeframes without understanding implications

Platform Limits

• Max 500 bars lookback for [] operator
• Max 500 plot calls
• Max 64 strategy.entry/exit calls per bar
• Max 40 request.security() calls

TradingView Symbol Format

When generating Pine Script, map Vibe-Trading codes to TradingView symbols:

Note: Pine Script strategies are chart-independent — the user applies them to whichever symbol they want on TradingView. Include a comment noting the original instrument.

Usage Instructions (include in response)

After generating the Pine Script, always include:

How to use in TradingView:
1. Open TradingView → Pine Editor (bottom panel)
2. Click "Open" → "New blank indicator"
3. Delete all existing code
4. Paste the Pine Script above
5. Click "Add to Chart"
6. The strategy will appear on your chart with entry/exit markers
7. Open "Strategy Tester" tab to see backtest results

Quality Checklist

Before outputting the Pine Script:

• //@version=6 is the first line
• strategy() declaration includes commission and initial_capital matching config.json
• All indicator calculations use Pine built-in ta.* functions (not manual reimplementation)
• Entry/exit conditions match the Python signal logic semantically
• No plot() inside local scopes (if/for/function)
• Ternary operators are on single lines
• Inputs use input.int() / input.float() so users can tune parameters in TradingView UI
• Alert conditions are included for key signals
• Comment header notes the original Vibe-Trading run_id and instrument