@neocage/council 1.3.0

package/configs/provider-model-slots.nim.example.yaml

@@ -0,0 +1,83 @@
+# NVIDIA NIM provider example for Council of Cognitive Excellence.
+# Use with: /council --profile exploration-orthogonal --models configs/provider-model-slots.nim.example.yaml "..."
+#
+# NVIDIA NIM (build.nvidia.com) exposes ~130 open-weight models via an
+# OpenAI-compatible endpoint at https://integrate.api.nvidia.com/v1.
+# Free tier: 1,000 inference credits on signup, 40 RPM rate limit.
+#
+# Setup:
+#   1. Get key at https://build.nvidia.com (key prefix: nvapi-)
+#   2. export NVIDIA_API_KEY=nvapi-...
+#   3. Verify live model IDs: curl -H "Authorization: Bearer $NVIDIA_API_KEY" \
+#         https://integrate.api.nvidia.com/v1/models | jq '.data[].id'
+#
+# Why mix providers: spreading seats across model families reduces shared
+# training-data bias and amplifies dissent. NIM gives access to non-Anthropic,
+# non-OpenAI, non-Google open-weight models (DeepSeek, Kimi, MiniMax, GLM, Qwen)
+# without separate provider accounts.
+
+profile: exploration-orthogonal
+strategy:
+  provider_spread_first: true
+  avoid_pair_collocation: true
+  force_counterfactual_if_consensus_gt: 0.70
+  require_dissenting_members: 2
+
+seats:
+  # Anthropic seats kept for high-stakes reasoning roles
+  socrates:
+    provider: anthropic
+    model: claude-sonnet-4
+    reasoning_mode: analytical
+  aurelius:
+    provider: anthropic
+    model: claude-opus-4
+    reasoning_mode: normative
+
+  # NIM seats — open-weight models via OpenAI-compatible API
+  feynman:
+    provider: nvidia_nim
+    model: deepseek-ai/deepseek-v4-pro
+    base_url: https://integrate.api.nvidia.com/v1
+    api_key_env: NVIDIA_API_KEY
+    reasoning_mode: mechanistic
+
+  sun-tzu:
+    provider: nvidia_nim
+    model: moonshotai/kimi-k2.6
+    base_url: https://integrate.api.nvidia.com/v1
+    api_key_env: NVIDIA_API_KEY
+    reasoning_mode: strategic
+
+  ada:
+    provider: nvidia_nim
+    model: qwen/qwen3.5-397b-a17b
+    base_url: https://integrate.api.nvidia.com/v1
+    api_key_env: NVIDIA_API_KEY
+    reasoning_mode: formal
+
+  machiavelli:
+    provider: nvidia_nim
+    model: z-ai/glm-5.1
+    base_url: https://integrate.api.nvidia.com/v1
+    api_key_env: NVIDIA_API_KEY
+    reasoning_mode: adversarial
+
+  lao-tzu:
+    provider: nvidia_nim
+    model: minimaxai/minimax-m2.7
+    base_url: https://integrate.api.nvidia.com/v1
+    api_key_env: NVIDIA_API_KEY
+    reasoning_mode: emergent
+
+  # Google for breadth on a third axis
+  torvalds:
+    provider: google
+    model: gemini-3-pro
+    reasoning_mode: pragmatic
+
+fallback:
+  provider: nvidia_nim
+  model: deepseek-ai/deepseek-v4-pro
+  base_url: https://integrate.api.nvidia.com/v1
+  api_key_env: NVIDIA_API_KEY

package/install.sh

@@ -0,0 +1,432 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Project version — derived from the latest released entry in CHANGELOG.md so
+# generated manifests never carry a stale hardcoded version.
+PROJECT_VERSION="$(sed -nE 's/^## \[([0-9]+\.[0-9]+\.[0-9]+)\].*/\1/p' "${SCRIPT_DIR}/CHANGELOG.md" 2>/dev/null | head -1)"
+PROJECT_VERSION="${PROJECT_VERSION:-0.0.0}"
+CLAUDE_DIR="${HOME}/.claude"
+CODEX_DIR="${HOME}/.codex"
+GEMINI_DIR="${HOME}/.gemini"
+OPENCODE_DIR="${HOME}/.config/opencode"
+DRY_RUN=false
+COPY_CONFIGS=false
+INSTALL_CLAUDE=true
+INSTALL_CODEX=false
+INSTALL_GEMINI=false
+INSTALL_OPENCODE=false
+
+usage() {
+  cat <<'EOF'
+Usage: ./install.sh [--claude-dir PATH] [--codex-dir PATH] [--gemini-dir PATH] [--opencode-dir PATH] [--codex] [--codex-only] [--gemini] [--gemini-only] [--opencode] [--opencode-only] [--copy-configs] [--dry-run] [--help]
+
+Install Council of Cognitive Excellence into Claude Code, Codex, Gemini CLI, and/or opencode skill directories.
+
+Options:
+  --claude-dir PATH    Target Claude config directory (default: ~/.claude)
+  --codex-dir PATH     Target Codex config directory (default: ~/.codex)
+  --gemini-dir PATH    Target Gemini config directory (default: ~/.gemini)
+  --opencode-dir PATH  Target opencode config directory (default: ~/.config/opencode)
+  --codex              Also install a Codex-compatible council skill
+  --codex-only         Install only the Codex skill
+  --gemini             Also install a Gemini-compatible council skill
+  --gemini-only        Install only the Gemini skill
+  --opencode           Also install an opencode-compatible council skill and native subagents
+  --opencode-only      Install only the opencode skill and subagents
+  --copy-configs       Also install repo configs/ into skill config folders
+  --dry-run            Print actions without writing files
+  --help               Show this help message
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --claude-dir)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --claude-dir requires a path argument" >&2
+        usage
+        exit 1
+      fi
+      CLAUDE_DIR="$2"
+      shift 2
+      ;;
+    --codex-dir)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --codex-dir requires a path argument" >&2
+        usage
+        exit 1
+      fi
+      CODEX_DIR="$2"
+      shift 2
+      ;;
+    --gemini-dir)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --gemini-dir requires a path argument" >&2
+        usage
+        exit 1
+      fi
+      GEMINI_DIR="$2"
+      shift 2
+      ;;
+    --opencode-dir)
+      if [[ $# -lt 2 ]]; then
+        echo "Error: --opencode-dir requires a path argument" >&2
+        usage
+        exit 1
+      fi
+      OPENCODE_DIR="$2"
+      shift 2
+      ;;
+    --codex)
+      INSTALL_CODEX=true
+      shift
+      ;;
+    --codex-only)
+      INSTALL_CLAUDE=false
+      INSTALL_CODEX=true
+      shift
+      ;;
+    --gemini)
+      INSTALL_GEMINI=true
+      shift
+      ;;
+    --gemini-only)
+      INSTALL_CLAUDE=false
+      INSTALL_GEMINI=true
+      shift
+      ;;
+    --opencode)
+      INSTALL_OPENCODE=true
+      shift
+      ;;
+    --opencode-only)
+      INSTALL_CLAUDE=false
+      INSTALL_OPENCODE=true
+      shift
+      ;;
+    --copy-configs)
+      COPY_CONFIGS=true
+      shift
+      ;;
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Error: unknown argument '$1'" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "${INSTALL_CLAUDE}" == false ]] && [[ "${INSTALL_CODEX}" == false ]] && [[ "${INSTALL_GEMINI}" == false ]] && [[ "${INSTALL_OPENCODE}" == false ]]; then
+  echo "Error: no install target selected" >&2
+  usage
+  exit 1
+fi
+
+run_cmd() {
+  if [[ "$DRY_RUN" == true ]]; then
+    echo "[dry-run] $*"
+  else
+    "$@"
+  fi
+}
+
+if [[ ! -d "${SCRIPT_DIR}/agents" ]]; then
+  echo "Error: agents directory not found at ${SCRIPT_DIR}/agents" >&2
+  exit 1
+fi
+
+if [[ "${INSTALL_CLAUDE}" == true ]] && [[ ! -f "${SCRIPT_DIR}/SKILL.md" ]]; then
+  echo "Error: SKILL.md not found at ${SCRIPT_DIR}/SKILL.md" >&2
+  exit 1
+fi
+
+if [[ "${INSTALL_CODEX}" == true ]] && [[ ! -f "${SCRIPT_DIR}/SKILL.codex.md" ]]; then
+  echo "Error: SKILL.codex.md not found at ${SCRIPT_DIR}/SKILL.codex.md" >&2
+  exit 1
+fi
+
+if [[ "${INSTALL_GEMINI}" == true ]] && [[ ! -f "${SCRIPT_DIR}/SKILL.gemini.md" ]]; then
+  echo "Error: SKILL.gemini.md not found at ${SCRIPT_DIR}/SKILL.gemini.md" >&2
+  exit 1
+fi
+
+if [[ "${INSTALL_OPENCODE}" == true ]] && [[ ! -f "${SCRIPT_DIR}/SKILL.opencode.md" ]]; then
+  echo "Error: SKILL.opencode.md not found at ${SCRIPT_DIR}/SKILL.opencode.md" >&2
+  exit 1
+fi
+
+shopt -s nullglob
+agent_files=("${SCRIPT_DIR}"/agents/council-*.md)
+shopt -u nullglob
+
+if [[ ${#agent_files[@]} -eq 0 ]]; then
+  echo "Error: no council agent files found under ${SCRIPT_DIR}/agents" >&2
+  exit 1
+fi
+
+CONFIGS_SRC_DIR="${SCRIPT_DIR}/configs"
+
+echo "Installing Council of Cognitive Excellence..."
+if [[ "${INSTALL_CLAUDE}" == true ]]; then
+  AGENTS_DEST="${CLAUDE_DIR}/agents"
+  CLAUDE_SKILL_DEST_DIR="${CLAUDE_DIR}/skills/council"
+  CLAUDE_SKILL_DEST="${CLAUDE_SKILL_DEST_DIR}/SKILL.md"
+  CLAUDE_CONFIGS_DEST_DIR="${CLAUDE_SKILL_DEST_DIR}/configs"
+  CLAUDE_SCRIPTS_DEST_DIR="${CLAUDE_SKILL_DEST_DIR}/scripts"
+
+  echo "Claude target directory: ${CLAUDE_DIR}"
+  echo "Creating Claude destination directories..."
+  run_cmd mkdir -p "${AGENTS_DEST}" "${CLAUDE_SKILL_DEST_DIR}"
+
+  echo "Installing Claude council agents..."
+  installed_count=0
+  for agent_file in "${agent_files[@]}"; do
+    run_cmd install -m 0644 "${agent_file}" "${AGENTS_DEST}/"
+    ((installed_count+=1))
+  done
+
+  echo "Installing Claude council skill..."
+  run_cmd install -m 0644 "${SCRIPT_DIR}/SKILL.md" "${CLAUDE_SKILL_DEST}"
+
+  echo "Installing Claude council scripts..."
+  run_cmd mkdir -p "${CLAUDE_SCRIPTS_DEST_DIR}"
+  scripts_installed=0
+  shopt -s nullglob
+  script_files=("${SCRIPT_DIR}"/scripts/detect-*.sh)
+  shopt -u nullglob
+  for script_file in "${script_files[@]}"; do
+    run_cmd install -m 0755 "${script_file}" "${CLAUDE_SCRIPTS_DEST_DIR}/"
+    ((scripts_installed+=1))
+  done
+
+  claude_configs_installed=0
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    if [[ -d "${CONFIGS_SRC_DIR}" ]]; then
+      run_cmd mkdir -p "${CLAUDE_CONFIGS_DEST_DIR}"
+      shopt -s nullglob
+      config_files=("${CONFIGS_SRC_DIR}"/*)
+      shopt -u nullglob
+      for config_file in "${config_files[@]}"; do
+        if [[ -f "${config_file}" ]]; then
+          run_cmd install -m 0644 "${config_file}" "${CLAUDE_CONFIGS_DEST_DIR}/"
+          ((claude_configs_installed+=1))
+        fi
+      done
+    else
+      echo "Warning: --copy-configs was set but ${CONFIGS_SRC_DIR} does not exist."
+    fi
+  fi
+fi
+
+if [[ "${INSTALL_CODEX}" == true ]]; then
+  CODEX_SKILL_DEST_DIR="${CODEX_DIR}/skills/council"
+  CODEX_SKILL_DEST="${CODEX_SKILL_DEST_DIR}/SKILL.md"
+  CODEX_AGENTS_DEST_DIR="${CODEX_SKILL_DEST_DIR}/agents"
+  CODEX_SCRIPTS_DEST_DIR="${CODEX_SKILL_DEST_DIR}/scripts"
+  CODEX_CONFIGS_DEST_DIR="${CODEX_SKILL_DEST_DIR}/configs"
+
+  echo "Codex target directory: ${CODEX_DIR}"
+  echo "Creating Codex destination directories..."
+  run_cmd mkdir -p "${CODEX_SKILL_DEST_DIR}" "${CODEX_AGENTS_DEST_DIR}" "${CODEX_SCRIPTS_DEST_DIR}"
+
+  echo "Installing Codex council skill..."
+  run_cmd install -m 0644 "${SCRIPT_DIR}/SKILL.codex.md" "${CODEX_SKILL_DEST}"
+
+  echo "Installing Codex council agents..."
+  codex_agents_installed=0
+  for agent_file in "${agent_files[@]}"; do
+    run_cmd install -m 0644 "${agent_file}" "${CODEX_AGENTS_DEST_DIR}/"
+    ((codex_agents_installed+=1))
+  done
+
+  echo "Installing Codex council scripts..."
+  codex_scripts_installed=0
+  shopt -s nullglob
+  codex_script_files=("${SCRIPT_DIR}"/scripts/detect-*.sh)
+  shopt -u nullglob
+  for script_file in "${codex_script_files[@]}"; do
+    run_cmd install -m 0755 "${script_file}" "${CODEX_SCRIPTS_DEST_DIR}/"
+    ((codex_scripts_installed+=1))
+  done
+
+  codex_configs_installed=0
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    if [[ -d "${CONFIGS_SRC_DIR}" ]]; then
+      run_cmd mkdir -p "${CODEX_CONFIGS_DEST_DIR}"
+      shopt -s nullglob
+      codex_config_files=("${CONFIGS_SRC_DIR}"/*)
+      shopt -u nullglob
+      for config_file in "${codex_config_files[@]}"; do
+        if [[ -f "${config_file}" ]]; then
+          run_cmd install -m 0644 "${config_file}" "${CODEX_CONFIGS_DEST_DIR}/"
+          ((codex_configs_installed+=1))
+        fi
+      done
+    else
+      echo "Warning: --copy-configs was set but ${CONFIGS_SRC_DIR} does not exist."
+    fi
+  fi
+fi
+
+if [[ "${INSTALL_GEMINI}" == true ]]; then
+  echo
+  GEMINI_EXT_ROOT="${GEMINI_DIR}/extensions/council-of-cognitive-excellence"
+  GEMINI_EXT_DEST_DIR="${GEMINI_EXT_ROOT}/skills/council"
+  GEMINI_SKILL_DEST="${GEMINI_EXT_DEST_DIR}/SKILL.md"
+  GEMINI_AGENTS_DEST_DIR="${GEMINI_EXT_DEST_DIR}/agents"
+  GEMINI_SCRIPTS_DEST_DIR="${GEMINI_EXT_DEST_DIR}/scripts"
+  GEMINI_CONFIGS_DEST_DIR="${GEMINI_EXT_DEST_DIR}/configs"
+
+  echo "Gemini target directory: ${GEMINI_DIR}"
+  echo "Creating Gemini destination directories..."
+  run_cmd mkdir -p "${GEMINI_EXT_DEST_DIR}" "${GEMINI_AGENTS_DEST_DIR}" "${GEMINI_SCRIPTS_DEST_DIR}"
+
+  echo "Writing gemini-extension.json manifest..."
+  if [[ "$DRY_RUN" == false ]]; then
+    cat <<EOF > "${GEMINI_EXT_ROOT}/gemini-extension.json"
+{
+  "name": "council-of-cognitive-excellence",
+  "version": "${PROJECT_VERSION}",
+  "description": "Council of Cognitive Excellence multiple persona deliberation system"
+}
+EOF
+  else
+    echo "[dry-run] Create ${GEMINI_EXT_ROOT}/gemini-extension.json"
+  fi
+
+  echo "Installing Gemini council skill..."
+  run_cmd install -m 0644 "${SCRIPT_DIR}/SKILL.gemini.md" "${GEMINI_SKILL_DEST}"
+
+  echo "Installing Gemini council agents..."
+  gemini_agents_installed=0
+  for agent_file in "${agent_files[@]}"; do
+    run_cmd install -m 0644 "${agent_file}" "${GEMINI_AGENTS_DEST_DIR}/"
+    ((gemini_agents_installed+=1))
+  done
+
+  echo "Installing Gemini council scripts..."
+  gemini_scripts_installed=0
+  shopt -s nullglob
+  gemini_script_files=("${SCRIPT_DIR}"/scripts/detect-*.sh)
+  shopt -u nullglob
+  for script_file in "${gemini_script_files[@]}"; do
+    run_cmd install -m 0755 "${script_file}" "${GEMINI_SCRIPTS_DEST_DIR}/"
+    ((gemini_scripts_installed+=1))
+  done
+
+  gemini_configs_installed=0
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    if [[ -d "${CONFIGS_SRC_DIR}" ]]; then
+      run_cmd mkdir -p "${GEMINI_CONFIGS_DEST_DIR}"
+      shopt -s nullglob
+      gemini_config_files=("${CONFIGS_SRC_DIR}"/*)
+      shopt -u nullglob
+      for config_file in "${gemini_config_files[@]}"; do
+        if [[ -f "${config_file}" ]]; then
+          run_cmd install -m 0644 "${config_file}" "${GEMINI_CONFIGS_DEST_DIR}/"
+          ((gemini_configs_installed+=1))
+        fi
+      done
+    else
+      echo "Warning: --copy-configs was set but ${CONFIGS_SRC_DIR} does not exist."
+    fi
+  fi
+fi
+
+if [[ "${INSTALL_OPENCODE}" == true ]]; then
+  echo
+  OPENCODE_SKILL_DEST_DIR="${OPENCODE_DIR}/skills/council"
+  OPENCODE_SKILL_DEST="${OPENCODE_SKILL_DEST_DIR}/SKILL.md"
+  OPENCODE_AGENTS_DEST_DIR="${OPENCODE_DIR}/agent"
+  OPENCODE_SCRIPTS_DEST_DIR="${OPENCODE_SKILL_DEST_DIR}/scripts"
+  OPENCODE_CONFIGS_DEST_DIR="${OPENCODE_SKILL_DEST_DIR}/configs"
+
+  echo "opencode target directory: ${OPENCODE_DIR}"
+  echo "Creating opencode destination directories..."
+  run_cmd mkdir -p "${OPENCODE_SKILL_DEST_DIR}" "${OPENCODE_AGENTS_DEST_DIR}" "${OPENCODE_SCRIPTS_DEST_DIR}"
+
+  echo "Installing opencode council skill..."
+  run_cmd install -m 0644 "${SCRIPT_DIR}/SKILL.opencode.md" "${OPENCODE_SKILL_DEST}"
+
+  echo "Converting and installing opencode council subagents..."
+  if [[ "$DRY_RUN" == true ]]; then
+    echo "[dry-run] python3 ${SCRIPT_DIR}/scripts/convert-agents-opencode.py ${SCRIPT_DIR}/agents ${OPENCODE_AGENTS_DEST_DIR}"
+    opencode_agents_installed=${#agent_files[@]}
+  else
+    opencode_agents_installed="$(python3 "${SCRIPT_DIR}/scripts/convert-agents-opencode.py" "${SCRIPT_DIR}/agents" "${OPENCODE_AGENTS_DEST_DIR}")"
+  fi
+
+  echo "Installing opencode council scripts..."
+  opencode_scripts_installed=0
+  shopt -s nullglob
+  opencode_script_files=("${SCRIPT_DIR}"/scripts/detect-*.sh)
+  shopt -u nullglob
+  for script_file in "${opencode_script_files[@]}"; do
+    run_cmd install -m 0755 "${script_file}" "${OPENCODE_SCRIPTS_DEST_DIR}/"
+    ((opencode_scripts_installed+=1))
+  done
+
+  opencode_configs_installed=0
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    if [[ -d "${CONFIGS_SRC_DIR}" ]]; then
+      run_cmd mkdir -p "${OPENCODE_CONFIGS_DEST_DIR}"
+      shopt -s nullglob
+      opencode_config_files=("${CONFIGS_SRC_DIR}"/*)
+      shopt -u nullglob
+      for config_file in "${opencode_config_files[@]}"; do
+        if [[ -f "${config_file}" ]]; then
+          run_cmd install -m 0644 "${config_file}" "${OPENCODE_CONFIGS_DEST_DIR}/"
+          ((opencode_configs_installed+=1))
+        fi
+      done
+    else
+      echo "Warning: --copy-configs was set but ${CONFIGS_SRC_DIR} does not exist."
+    fi
+  fi
+fi
+
+echo
+echo "Done."
+if [[ "${INSTALL_CLAUDE}" == true ]]; then
+  echo "  Installed ${installed_count} council agents to ${AGENTS_DEST}"
+  echo "  Installed skill to ${CLAUDE_SKILL_DEST}"
+  echo "  Installed ${scripts_installed} scripts to ${CLAUDE_SCRIPTS_DEST_DIR}"
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    echo "  Installed ${claude_configs_installed} config files to ${CLAUDE_CONFIGS_DEST_DIR}"
+  fi
+fi
+if [[ "${INSTALL_CODEX}" == true ]]; then
+  echo "  Installed Codex skill to ${CODEX_SKILL_DEST}"
+  echo "  Installed ${codex_agents_installed} Codex council agents to ${CODEX_AGENTS_DEST_DIR}"
+  echo "  Installed ${codex_scripts_installed} Codex scripts to ${CODEX_SCRIPTS_DEST_DIR}"
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    echo "  Installed ${codex_configs_installed} Codex config files to ${CODEX_CONFIGS_DEST_DIR}"
+  fi
+fi
+if [[ "${INSTALL_GEMINI}" == true ]]; then
+  echo "  Installed Gemini skill to ${GEMINI_SKILL_DEST}"
+  echo "  Installed ${gemini_agents_installed} Gemini council agents to ${GEMINI_AGENTS_DEST_DIR}"
+  echo "  Installed ${gemini_scripts_installed} Gemini scripts to ${GEMINI_SCRIPTS_DEST_DIR}"
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    echo "  Installed ${gemini_configs_installed} Gemini config files to ${GEMINI_CONFIGS_DEST_DIR}"
+  fi
+fi
+if [[ "${INSTALL_OPENCODE}" == true ]]; then
+  echo "  Installed opencode skill to ${OPENCODE_SKILL_DEST}"
+  echo "  Installed ${opencode_agents_installed} opencode council subagents to ${OPENCODE_AGENTS_DEST_DIR}"
+  echo "  Installed ${opencode_scripts_installed} opencode scripts to ${OPENCODE_SCRIPTS_DEST_DIR}"
+  if [[ "$COPY_CONFIGS" == true ]]; then
+    echo "  Installed ${opencode_configs_installed} opencode config files to ${OPENCODE_CONFIGS_DEST_DIR}"
+  fi
+fi
+
+echo "Restart your CLI client(s) and use /council to convene the council."

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@neocage/council",
+  "version": "1.3.0",
+  "description": "18 AI personas deliberate your hardest decisions — structured multi-round deliberation with model diversity across providers.",
+  "keywords": [
+    "deliberation",
+    "multi-agent",
+    "decision-making",
+    "debate",
+    "personas",
+    "multi-llm",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "opencode"
+  ],
+  "homepage": "https://github.com/NeoCage/Council-of-Cognitive-Excellence",
+  "bugs": "https://github.com/NeoCage/Council-of-Cognitive-Excellence/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeoCage/Council-of-Cognitive-Excellence.git"
+  },
+  "license": "MIT",
+  "author": "NeoCage (https://github.com/NeoCage)",
+  "type": "commonjs",
+  "bin": {
+    "council": "bin/council.js"
+  },
+  "files": [
+    "bin/",
+    "agents/",
+    "scripts/",
+    "configs/",
+    "skills/",
+    "SKILL.md",
+    "SKILL.codex.md",
+    "SKILL.gemini.md",
+    "SKILL.opencode.md",
+    "install.sh",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/convert-agents-opencode.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""Convert council-*.md Claude subagent files into opencode-compatible subagent files.
+
+opencode's agent frontmatter schema is stricter than Claude's: it rejects the
+`tools: [...]` array (deprecated in opencode, replaced by `permission`), rejects
+free-form `color` names (must be a hex code or a fixed theme keyword), and has
+no notion of Claude's `opus`/`sonnet` model aliases. This script re-shapes each
+agent's frontmatter to fit while preserving the original routing metadata
+(`council:` block, including the Claude tier) for the coordinator skill to
+reference.
+
+Usage: convert-agents-opencode.py <src_agents_dir> <dst_agents_dir>
+"""
+import re
+import sys
+from pathlib import Path
+
+try:
+    import yaml
+except ImportError:
+    sys.exit(
+        "Error: PyYAML is required. Install it with: pip3 install --user pyyaml"
+    )
+
+FRONTMATTER_RE = re.compile(r"^---\n(.*?)\n---\n", re.DOTALL)
+
+
+def convert(src_path: Path) -> str:
+    text = src_path.read_text()
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        raise ValueError(f"no frontmatter in {src_path}")
+    fm = yaml.safe_load(m.group(1))
+    body = text[m.end():]
+
+    council = fm.get("council", {}) or {}
+    council["claude_tier"] = fm.get("model")
+
+    new_fm = {
+        "description": fm["description"],
+        "mode": "subagent",
+        "permission": {"edit": "deny", "write": "deny"},
+        "council": council,
+    }
+
+    new_frontmatter = yaml.safe_dump(
+        new_fm, sort_keys=False, default_flow_style=False, allow_unicode=True
+    )
+    return f"---\n{new_frontmatter}---\n{body}"
+
+
+def main():
+    if len(sys.argv) != 3:
+        sys.exit(f"Usage: {sys.argv[0]} <src_agents_dir> <dst_agents_dir>")
+    src_dir, dst_dir = Path(sys.argv[1]), Path(sys.argv[2])
+    dst_dir.mkdir(parents=True, exist_ok=True)
+
+    converted = 0
+    for src in sorted(src_dir.glob("council-*.md")):
+        (dst_dir / src.name).write_text(convert(src))
+        converted += 1
+
+    print(converted)
+
+
+if __name__ == "__main__":
+    main()