/pine-publisher

name: pine-publisher
description: Prepares Pine Scripts for TradingView publication with documentation and compliance checks. Use when finalizing scripts for release.
disable-model-invocation: true
allowed-tools: Read, Edit, Grep, Glob

Pine Script Publisher

Specialized in preparing scripts for publication in TradingView's community library.

Core Responsibilities

Publication Compliance

• Ensure House Rules compliance
• Add required documentation
• Include proper attributions
• Remove any prohibited content

Documentation Creation

• Write comprehensive descriptions
• Create usage instructions
• Document all parameters
• Add example configurations

Metadata Optimization

• Create SEO-friendly titles
• Add relevant tags/categories
• Write compelling descriptions
• Include version information

Professional Presentation

• Clean code formatting
• Consistent naming conventions
• Professional comments
• Example screenshots ready

Pine Script v6 2025 Publishing Requirements

CRITICAL: Use Latest Syntax

Published scripts should use 2025 features for best user experience:

**1. Input `active` Parameter (July 2025)**

// ✅ Professional: Conditional input visibility
showAdvanced = input.bool(false, "Advanced Mode", group="Settings")
advSetting = input.int(10, "Advanced Setting",
    group="Settings",
    active=showAdvanced,  // Grayed out when disabled
    tooltip="Only available in Advanced Mode")

**2. Plot Line Styles (September 2025)**

// ✅ Professional: Visual hierarchy with line styles
plot(mainMA, "Main MA", color.blue, linestyle=plot.linestyle_solid)
plot(signalLine, "Signal", color.yellow, linestyle=plot.linestyle_dashed)
plot(target, "Target", color.green, linestyle=plot.linestyle_dotted)

**3. Use `for...in` for Collections (March 2025)**

// ✅ BEST: Use for...in (safe, clean, prevents freezing)
for element in myArray
    // Process element directly

// ✅ With index when needed
for [index, element] in myArray
    // Have both index and value

// ⚠️ FALLBACK: If traditional for needed, cache boundary
arrSize = array.size(myArray)
for i = 0 to arrSize - 1
    // Process...

2025 Feature Checklist for Publication

• [ ] Uses `active` parameter for conditional inputs
• [ ] Uses `linestyle` for visual differentiation
• [ ] Loops use `for...in` (preferred) or cached boundaries
• [ ] Ternary operators on single lines (no syntax errors)
• [ ] String lengths within 40,960 char limit

TradingView House Rules Compliance

Required Elements

**For Indicators:**

// built with PineScript Agents by TradersPost
//@version=6
//@description Comprehensive description of what the indicator does

indicator(title="Professional Indicator Name - Clear Description v1.0",
         shorttitle="PRO IND",
         overlay=true)

**For Strategies (CRITICAL: Include alert annotation):**

// built with PineScript Agents by TradersPost
//@version=6
//@description Comprehensive description of what the strategy does

strategy(title="Professional Strategy Name - Clear Description v1.0",
         shorttitle="PRO STRAT",
         overlay=true)
//@strategy_alert_message {{strategy.order.alert_message}}

// ============================================================================
// METADATA
// ============================================================================
// Author: Your Name / Username
// Version: 1.0
// Date: 2024-01-15
// Category: Trend Following / Momentum / Volatility / Volume
//
// Description:
// This indicator/strategy provides [clear explanation of functionality].
// It uses [main components/calculations] to generate [type of signals].
//
// Features:
// • Feature 1 description
// • Feature 2 description
// • Feature 3 description
//
// How to Use:
// 1. Add to your chart
// 2. Configure settings as needed
// 3. Look for [signal types]
// 4. Use in conjunction with [complementary analysis]
//
// ============================================================================

Prohibited Content

• No financial advice
• No promises of profitability
• No external links (except documentation)
• No contact information in code
• No obfuscated/minified code
• No requests for donations/tips
• No malicious code

Documentation Templates

IMPORTANT: Script Description Location

**Pine Script descriptions should be written as comments at the top of the .pine file**, immediately after the version declaration and before the indicator/strategy declaration.

1. Indicator Documentation (Place at TOP of .pine file)

//@version=6

// ============================================================================
// DOCUMENTATION - THIS GOES AT THE TOP OF YOUR PINE SCRIPT FILE
// ============================================================================
//
// INDICATOR OVERVIEW
// ==================
// This indicator identifies [specific market conditions] by analyzing
// [data sources used]. It is designed for [target audience/use case].
//
// CALCULATION METHOD
// ==================
// The indicator calculates:
// 1. [First calculation] using [formula/method]
// 2. [Second calculation] based on [inputs]
// 3. [Final signal] when [conditions are met]
//
// SIGNALS INTERPRETATION
// ======================
// • Green Triangle: [What it means]
// • Red Triangle: [What it means]
// • Blue Line: [What it represents]
// • Shaded Area: [What it indicates]
//
// SETTINGS GUIDE
// ==============
// Length: Controls the lookback period. Lower = more responsive, Higher = smoother
// Threshold: Sets sensitivity. Range 0-100, default 50
// Mode: Choose between Conservative/Normal/Aggressive
//
// BEST PRACTICES
// ==============
// • Works best on [timeframes]
// • Most effective in [market conditions]
// • Combine with [other indicators] for confirmation
// • Avoid using during [specific conditions]
//
// LIMITATIONS
// ===========
// • May repaint in [specific scenarios]