Use ~/.local source for SKILL.md instead of copying to ~/.config

cli/src/update.py

@@ -55,8 +55,6 @@ def update(
             _reinstall_editable_packages(repo_root)
             reinstalled = True
 
-        _sync_skill_files(repo_root)
-
         print_output(
             {
                 "repo": str(repo_root),
@@ -139,17 +137,6 @@ def _reinstall_editable_packages(repo_root: Path) -> None:
     )
 
 
-def _sync_skill_files(repo_root: Path) -> None:
-    config_home = Path(os.environ.get("BROKER_CONFIG_HOME", "").strip() or
-                       Path(os.environ.get("XDG_CONFIG_HOME", "").strip() or
-                            Path.home() / ".config") / "broker")
-    skill_source = repo_root / "skills" / "broker" / "SKILL.md"
-    skill_target = config_home / "skills" / "broker" / "SKILL.md"
-    if skill_source.is_file():
-        skill_target.parent.mkdir(parents=True, exist_ok=True)
-        shutil.copy2(skill_source, skill_target)
-
-
 def _git(repo_root: Path, *args: str) -> str:
     return _run(["git", *args], cwd=repo_root)
 

install/main.sh

@@ -57,7 +57,7 @@ fi
 # Install-only shared steps (provider-specific dependencies are installed in setup.sh)
 # 1. Prepare dirs  2. Bootstrap tooling  3. Create config
 # 4. Python runtime  5. Python packages  6. Link CLI  7. Completions
-STEP_TOTAL=8
+STEP_TOTAL=7
 
 # ─── Install ─────────────────────────────────────────────────────────────────
 
@@ -68,7 +68,6 @@ run_step "Creating broker config (${BROKER_CONFIG_JSON})" ensure_broker_config
 run_step "Creating Python runtime" create_python_runtime
 run_step "Installing broker Python packages" install_python_packages
 run_step "Linking broker CLI command" bind_broker_command
-run_step "Installing skill files" install_skill_files
 run_step "Installing shell completions" install_shell_completions
 
 # ─── Done ─────────────────────────────────────────────────────────────────────

install/steps/summary.sh

@@ -84,7 +84,7 @@ print_summary() {
 ${BOLD}${GREEN}Broker Install Complete (E*Trade)${RESET}
 
 Config: ${BROKER_CONFIG_JSON}
-Skill file: ${BROKER_CONFIG_HOME}/skills/broker/SKILL.md
+Skill file: ${BROKER_DATA_HOME}/source/skills/broker/SKILL.md
 Tokens: ${BROKER_CONFIG_HOME}/etrade-tokens.json
 Fund repo: ${fund_dir:-"(not configured)"}
 
@@ -101,7 +101,7 @@ SUMMARY
 ${BOLD}${GREEN}Broker Install Complete${RESET}
 
 Config: ${BROKER_CONFIG_JSON}
-Skill file: ${BROKER_CONFIG_HOME}/skills/broker/SKILL.md
+Skill file: ${BROKER_DATA_HOME}/source/skills/broker/SKILL.md
 Runtime state: ${BROKER_STATE_HOME}
 Runtime data: ${BROKER_DATA_HOME}
 Fund repo: ${fund_dir:-"(not configured)"}

install/steps/workspace.sh

@@ -6,15 +6,6 @@ prepare_broker_home() {
   mkdir -p "${BROKER_DATA_HOME}"
 }
 
-install_skill_files() {
-  local skill_source="${ROOT_DIR}/skills/broker/SKILL.md"
-  local skill_target="${BROKER_CONFIG_HOME}/skills/broker/SKILL.md"
-  if [[ -f "${skill_source}" ]]; then
-    mkdir -p "$(dirname "${skill_target}")"
-    cp "${skill_source}" "${skill_target}"
-  fi
-}
-
 ensure_broker_config() {
   mkdir -p "${BROKER_CONFIG_HOME}"
   if ! command -v python3 >/dev/null 2>&1; then

setup.sh

@@ -114,6 +114,6 @@ echo ""
 echo "${GREEN}✔${RESET} Setup complete."
 echo ""
 echo "  Config:     ${BROKER_CONFIG_JSON}"
-echo "  Skill file: ${BROKER_CONFIG_HOME}/skills/broker/SKILL.md"
+echo "  Skill file: ${BROKER_DATA_HOME}/source/skills/broker/SKILL.md"
 echo ""
 echo "${BLUE}→${RESET} Try: ${BOLD}${BLUE}broker daemon start${RESET}"

skills/broker/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: broker-cli
+name: broker
 description: Complete reference for the broker CLI. Use when translating trading intentions into exact `broker` commands. Covers all commands, flags, defaults, workflows, and error handling.
 ---
 

website/app/reference/page.tsx

@@ -608,7 +608,7 @@ export default function ReferencePage() {
                 <tbody>
                   {[
                     ["Config", "~/.config/broker/config.json"],
-                    ["Skill file", "~/.config/broker/skills/broker/SKILL.md"],
+                    ["Skill file", "~/.local/share/broker/source/skills/broker/SKILL.md"],
                     ["E*Trade tokens", "~/.config/broker/etrade_tokens.json"],
                     ["Daemon socket", "~/.local/state/broker/broker.sock"],
                     ["Daemon log", "~/.local/state/broker/broker.log"],