synero

name	synero
description	Ask Synero’s AI Council questions from the terminal and get one synthesized answer from four contrasting AI advisors. Use when a user wants a higher-confidence take on strategy, research, architecture, hiring, positioning, or other judgment-heavy questions where multiple perspectives beat a single-model reply.

Synero Skill

Use this skill to query Synero from the terminal when one AI answer is not enough. Synero is positioned as a collective AI intelligence product: one prompt goes to four advisors with different reasoning styles, then Synero synthesizes them into a single response.

This is most useful for ambiguous or high-leverage questions where you want disagreement, tradeoffs, blind-spot checking, and a clearer final recommendation.

What this skill helps with

Use it for prompts like:

• product or roadmap decisions with meaningful tradeoffs
• technical architecture reviews and go/no-go questions
• research questions where cross-checking perspectives improves trust
• hiring, org, or leadership choices with second-order effects
• messaging, positioning, or content strategy that benefits from competing angles

Prefer simpler tools for basic factual lookups or one-shot chores. This skill shines when the question is judgment-heavy.

What it does

• Sends a prompt to Synero’s council endpoint
• Supports 4 advisor roles: architect, philosopher, explorer, maverick
• Returns either:
  • a synthesized final answer for normal use, or
  • raw SSE stream output for debugging and live visibility
• Supports optional thread continuity and per-slot model overrides

Prerequisites

Get your API key from https://synero.ai, then export it before running the script:

export SYNERO_API_KEY="sk_live_..."

If you are not sure where to get the key, sign in at https://synero.ai and use the API/settings area there.

Optional environment variables:

export SYNERO_API_URL="https://synero.ai/api/query"
export SYNERO_TIMEOUT="120"
export SYNERO_MODEL_ARCHITECT="gpt-5.2"
export SYNERO_MODEL_PHILOSOPHER="claude-opus-4-6"
export SYNERO_MODEL_EXPLORER="gemini-3.1-pro-preview"
export SYNERO_MODEL_MAVERICK="grok-4"
export SYNERO_MODEL_SYNTHESIZER="gpt-4.1"

Quick command

python3 ~/.openclaw/skills/synero/scripts/synero-council.py "Should we ship this feature in the next 30 days?"

That command uses SYNERO_API_KEY from your environment and sends the request to Synero at https://synero.ai/api/query unless you override SYNERO_API_URL.

Quiet final-output mode

Use --quiet when you want only the synthesized answer with no extra status lines:

python3 ~/.openclaw/skills/synero/scripts/synero-council.py --quiet "Evaluate this architecture plan and recommend a prototype path."

Streaming and debugging mode

Use --raw when you want the raw event stream for troubleshooting or to inspect council behavior live:

python3 ~/.openclaw/skills/synero/scripts/synero-council.py --raw "What are the strongest arguments for and against this pricing change?"

Advanced configuration

Use model overrides when you want to pin specific advisors or a specific synthesizer:

python3 ~/.openclaw/skills/synero/scripts/synero-council.py \
  --thread-id "your-thread-id" \
  --advisor-model architect=gpt-5.2 \
  --advisor-model philosopher=claude-opus-4-6 \
  --advisor-model explorer=gemini-3.1-pro-preview \
  --advisor-model maverick=grok-4 \
  --synthesizer-model gpt-4.1 \
  "Your question"

Output behavior

Default mode prints:

• HTTP status line
• final synthesized answer

--quiet prints:

• final synthesized answer only

--raw prints:

• raw SSE events from the API

Prompting guidance

Write prompts that invite useful disagreement, not generic brainstorming.

• Ask for tradeoffs, risks, assumptions, and a recommendation
• Include operating constraints such as timeline, budget, team size, and risk tolerance
• Use --thread-id when continuing the same topic across multiple rounds
• Use --quiet when another tool or script needs clean final text only
• Use --raw when debugging streaming behavior or inspecting advisor outputs

For reusable prompt templates, read:

• references/prompt-patterns.md

Error handling

• Missing key → exits with clear guidance to set SYNERO_API_KEY
• HTTP failure → prints status and response body
• Network failure → prints a clear network error
• Empty synthesis → exits non-zero instead of pretending things are fine