Referência de Skills

Schema YAML Completo

Campo	Tipo	Faixa	Padrão	Obrigatório	Descrição
name	string	-	-	Sim	Nome da skill (único, slug)
description	string	-	-	Sim	Descrição do que a skill faz
category	string	WORKFLOW	WORKFLOW	Sim	Sempre WORKFLOW
asset_class	string[]	-	-	Sim	Lista de ativos (ex: [BTC, ETH])
timeframe	string	1m-1d	1h	Sim	Intervalo de tempo (1m, 5m, 15m, 1h, 4h, 1d)
market_regime	string[]	bull,bear,ranging,volatile	-	Sim	Regimes permitidos ([bull, bear, ranging, volatile])
blocked_regimes	string[]	bull,bear,ranging,volatile	[]	Nao	Regimes onde esta skill nao pode operar
risk_profile	string	-	moderate	Nao	Perfil de risco (conservative, moderate, aggressive)
rules.min_conditions_pct	float	0.0-1.0	1.0	Nao	Fracao minima de condicoes de entrada que devem ser satisfeitas (0.6 = 60% basta, 1.0 = todas obrigatorias)
rules.entry	object[]	-	-	Sim	Lista de condicoes para abrir posicao
rules.exit	object[]	-	-	Sim	Lista de condições para fechar posição
rules.risk.stop_loss	float	0.01-0.10	0.02	Sim	Percentual máximo de perda (0.01 a 0.10)
rules.risk.take_profit	float	0.01-0.20	0.03	Nao	Percentual alvo de lucro (0.01 a 0.20)
rules.risk.max_position_pct	float	0.01-0.20	0.05	Nao	Percentual máximo do portfolio por trade
confidence.pipeline	string	-	linear	Sim	Tipo de pipeline (linear, gaussian, stepped)
confidence.base	float	0.0-1.0	0.50	Sim	Valor base de confiança (0.0 a 1.0)
confidence.floor	float	0.0-1.0	0.40	Nao	Valor mínimo de confiança
confidence.ceiling	float	0.0-1.0	0.80	Nao	Valor máximo de confiança
confidence.bonuses	object[]	-	[]	Nao	Lista de bonuses condicionais
confidence.penalties	object[]	-	[]	Nao	Lista de penalidades condicionais
confidence.caps	object[]	-	[]	Nao	Limites de confiança por cenario
confidence.kill_switches	object[]	-	[]	Nao	Condições que param a skill

Exemplo Completo: Mean Reversion BTC 1H

---
name: mean-reversion-btc-1h
description: Mean reversion strategy for BTC using Bollinger Bands and RSI.
category: WORKFLOW
asset_class: [BTC]
timeframe: 1h
market_regime: [ranging]
risk_profile: conservative

rules:
  entry:
    - indicator: Bollinger_Position(20, 2.0)
      condition: below
      value: 0.05
    - indicator: RSI(14)
      condition: below
      value: 30
    - indicator: Volume_Ratio(5, 20)
      condition: above
      value: 1.5
  exit:
    - indicator: Bollinger_Position(20, 2.0)
      condition: above
      value: 0.50
    - indicator: RSI(14)
      condition: above
      value: 70
  risk:
    stop_loss: 0.02
    take_profit: 0.03
    max_position_pct: 0.05
  confidence:
    pipeline: linear
    base: 0.50
    floor: 0.45
    ceiling: 0.75
    bonuses:
      - when: rsi_deeply_oversold
        add: 0.05
      - when: bollinger_touch_lower
        add: 0.04
      - when: volume_confirms_reversal
        add: 0.03
    penalties:
      - when: trend_strongly_down
        sub: 0.06
      - when: no_volume_confirmation
        sub: 0.04
    kill_switches:
      - when: price_in_freefall
        floor: 0.45
        reason: "Price in freefall (>5% drop in 4h)"
---

Exemplo: Momentum ETH 4H

---
name: momentum-eth-4h
description: Momentum strategy for ETH on 4h using MACD and ADX.
category: WORKFLOW
asset_class: [ETH]
timeframe: 4h
market_regime: [trending]
risk_profile: moderate

rules:
  entry:
    - indicator: MACD(12, 26, 9)
      condition: crosses_above
      value: 0
    - indicator: ADX(14)
      condition: above
      value: 25
    - indicator: Volume_Ratio(5, 20)
      condition: above
      value: 1.2
  exit:
    - indicator: MACD(12, 26, 9)
      condition: crosses_below
      value: 0
    - indicator: RSI(14)
      condition: above
      value: 75
  risk:
    stop_loss: 0.03
    take_profit: 0.06
    max_position_pct: 0.05
  confidence:
    pipeline: linear
    base: 0.55
    floor: 0.40
    ceiling: 0.80
    bonuses:
      - when: adx_strong_trend
        add: 0.05
      - when: volume_confirms_reversal
        add: 0.03
    penalties:
      - when: rsi_overbought
        sub: 0.04
    kill_switches:
      - when: volume_below_minimum
        floor: 0.40
        reason: "Volume too low for reliable momentum"
---

Perguntas Frequentes

Quantas condições de entrada devo ter?

Recomendamos entre 2 e 5 condições. Poucas condições geram muitos sinais falsos. Muitas condições fazem a skill nunca operar.

Qual stop loss usar?

Para iniciantes, 2-3% e seguro. Use ATR para stops dinamicos que se adaptam a volátilidade. Nunca opere sem stop loss.

O que acontece se minha skill não operar?

Se as condições sao muito restritivas, a skill pode nunca encontrar oportunidade. Relaxe os thresholds ou reduza o número de condições obrigatorias.

Como sei se minha skill tem overfitting?

Use walk-forward validation. Se a performance e muito melhor no treino do que na validação, provavelmente ha overfitting. Reduza o número de parâmetros e simplifique.

Solucao de Problemas

Skill nunca abre posição

Condições muito restritivas. Verifique se os thresholds sao realistas para o ativo e timeframe escolhidos.

Muitos trades com perda

Sinais fracos ou regime errado. Adicione condições de confirmação (ex: volume) e verifique se o market_regime esta correto.

Grounding score muito baixo

Poucos dados confirmando o sinal. Adicione mais indicadores de confirmação e verifique se o volume e suficiente.