2026-07-10 11:23:51 +02:00
#!/usr/bin/env bash
# Render the skills from skills-lock.json and copy them into TARGET.
# TARGET defaults to $HOME (global install); pass a project root to
# equip that project. Skills land in <TARGET>/.agents/skills and are
2026-11-11 20:33:54 +00:00
# mirrored to <TARGET>/.claude/skills. A project install links every skill
# the global install in $HOME already holds to that copy instead.
2026-07-10 11:23:51 +02:00
set -euo pipefail
SCRIPT_DIR = " $( cd -- " $( dirname -- " ${ BASH_SOURCE [0] } " ) " && pwd ) "
REPO_ROOT = " $( cd -- " ${ SCRIPT_DIR } /.." && pwd ) "
TARGET = " ${ TARGET :- ${ HOME }} "
log() { printf '%s\n' " $* " ; }
warn() { printf '%s\n' " $* " >& 2; }
if ! command -v npx & >/dev/null; then
warn "skills: npx not found — install Node.js first: https://nodejs.org"
exit 1
fi
if [[ ! -d " ${ TARGET } " ]] ; then
warn "skills: TARGET does not exist: ${ TARGET } "
exit 2
fi
2026-11-14 21:18:41 +00:00
council_root = " ${ REPO_ROOT } /skills/kvb-org-organize/scripts/councilroot.py"
has_user_systemd() { command -v systemctl & >/dev/null && systemctl --user show-environment & >/dev/null; }
resume_units() {
bash " ${ REPO_ROOT } /scripts/orchestrator.sh" start || true
if has_user_systemd; then systemctl --user start kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.path || true; fi
}
# Args: extra councilroot.py migrate arguments. Returns its exit code; on 3
# or 5 every file it left behind or kept beside its namesake is named on stderr.
migrate_council() {
local report code = 0
report = " $( python3 " ${ council_root } " migrate " $@ " ) " || code = $?
log " ${ report } "
if (( code == 3 || code == 5)) ; then
warn "skills: the council root migration left these files in the earlier root or beside their namesakes; merge them by hand, the install exits 1 at the end:"
grep -E '^(unmoved|conflict|kept) ' <<< " ${ report } " | sed 's/^/skills: /' >& 2 || true
fi
return " ${ code } "
}
status = 0
if [[ " ${ TARGET } " == " ${ HOME } " ]] ; then
if ! python3 " ${ council_root } " preflight; then
warn "skills: install refused before copying anything; the installed skills keep the earlier council root until the reasons above are gone."
exit 1
fi
fi
2026-07-10 11:23:51 +02:00
cd " ${ REPO_ROOT } "
2026-10-30 15:17:45 +01:00
src = " ${ REPO_ROOT } /.agents/skills"
rm -rf " ${ src } "
2026-07-10 11:23:51 +02:00
log "skills: restoring from skills-lock.json..."
npx --yes skills experimental_install
if [[ ! -d " ${ src } " ]] ; then
warn "skills: ${ src } not found after install."
exit 1
fi
2026-07-10 12:54:47 +02:00
if [[ -d " ${ REPO_ROOT } /skills" ]] ; then
log "skills: adding first-party skills from skills/..."
cp -a " ${ REPO_ROOT } /skills/." " ${ src } /"
fi
2026-11-14 21:18:41 +00:00
if [[ " ${ TARGET } " == " ${ HOME } " ]] ; then
install -d -m 0700 " $( python3 " ${ council_root } " durable) "
if has_user_systemd; then
systemctl --user stop kvb-org-queue-cleanup.path kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.service & >/dev/null || true
fi
if ! bash " ${ REPO_ROOT } /scripts/orchestrator.sh" stop; then
resume_units
warn "skills: install refused before copying anything: the Agent Orchestrator did not stop."
exit 1
fi
moved = 0
migrate_council || moved = $?
marker = " $( python3 " ${ council_root } " durable) /migrate.started"
if [[ -e " ${ marker } " ]] ; then
warn "skills: the council root migration stopped halfway (exit ${ moved } ): ${ marker } exists; the install copies the new skills so they read the new root and exits 1 at the end; 'python3 ${ council_root } migrate --catch-up' finishes the move and removes ${ marker } ."
status = 1
elif (( moved == 3 || moved == 5)) ; then
status = 1
elif (( moved != 0)) ; then
resume_units
warn "skills: install refused before copying anything: the council root migration failed (exit ${ moved } ); run the install again once the reasons above are gone."
exit 1
fi
fi
2026-11-11 20:33:54 +00:00
for root in .agents/skills .claude/skills; do
dst = " ${ TARGET } / ${ root } "
2026-07-10 11:23:51 +02:00
log "skills: copying -> ${ dst } "
mkdir -p " ${ dst } "
2026-11-13 11:18:31 +00:00
find -H " ${ dst } " -mindepth 1 -delete
2026-07-10 11:23:51 +02:00
cp -a " ${ src } /." " ${ dst } /"
2026-11-13 11:18:31 +00:00
find -H " ${ dst } " \( -name __pycache__ -o -name '*.py[co]' \) -prune -exec rm -rf {} +
2026-11-11 20:33:54 +00:00
if [[ ! " ${ TARGET } " -ef " ${ HOME } " ]] ; then
log "skills: linking in ${ dst } what ${ HOME } / ${ root } already holds"
for skill in " ${ dst } " /*; do
global = " ${ HOME } / ${ root } / ${ skill ##*/ } "
if [[ -e " ${ global } " ]] ; then
rm -rf " ${ skill } "
ln -s " ${ global } " " ${ skill } "
fi
done
fi
2026-07-10 11:23:51 +02:00
done
2026-11-14 21:18:41 +00:00
if [[ " ${ TARGET } " == " ${ HOME } " ]] ; then
caught = 0
migrate_council --catch-up || caught = $?
if (( caught != 0)) ; then
status = 1
fi
if (( caught != 0 && caught != 3 && caught != 5)) ; then
warn "skills: the catch-up council root migration failed (exit ${ caught } ); what the old skills wrote during the install stays in the earlier root until 'python3 ${ council_root } migrate --catch-up' succeeds."
fi
fi
2026-09-21 22:30:53 +02:00
settings = " ${ TARGET } /.claude/settings.local.json"
2026-07-10 14:59:17 +02:00
if command -v node & >/dev/null; then
log "skills: auto-enabling caveman + ponytail plugins in ${ settings } "
node " ${ REPO_ROOT } /scripts/enable-plugins.js" " ${ settings } "
2026-11-13 11:22:49 +00:00
if [[ " ${ TARGET } " -ef " ${ HOME } " ]] ; then
node " ${ REPO_ROOT } /scripts/council-deny.js" " ${ HOME } /.claude/settings.json"
fi
2026-07-10 14:59:17 +02:00
else
warn "skills: node not found; skipped auto-enabling caveman/ponytail plugins."
fi
2026-11-03 13:43:15 +01:00
if [[ " ${ TARGET } " == " ${ HOME } " ]] ; then
2026-11-14 21:18:41 +00:00
if has_user_systemd; then
2026-11-13 10:45:49 +00:00
log "skills: enabling the daily kvb-dream notification timer and the kvb-org-queue-cleanup rounds at 00:00, 12:00 and on request"
2026-11-03 13:43:15 +01:00
units = " ${ HOME } /.config/systemd/user"
mkdir -p " ${ units } "
cp -f " ${ REPO_ROOT } /skills/kvb-dream/systemd/kvb-dream-notify.service" " ${ REPO_ROOT } /skills/kvb-dream/systemd/kvb-dream-notify.timer" " ${ units } /"
2026-11-13 10:45:49 +00:00
cp -f " ${ REPO_ROOT } /skills/kvb-org-queue-cleanup/systemd/kvb-org-queue-cleanup." { service,timer,path} " ${ units } /"
2026-11-03 13:43:15 +01:00
systemctl --user daemon-reload
2026-11-13 10:45:49 +00:00
systemctl --user enable --now kvb-dream-notify.timer kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.path
2026-11-03 13:43:15 +01:00
else
2026-11-13 10:45:49 +00:00
warn "skills: no systemd user session; skipped the kvb-dream notification timer and the kvb-org-queue-cleanup rounds."
2026-11-03 13:43:15 +01:00
fi
2026-11-06 08:28:04 +00:00
if command -v docker & >/dev/null; then
2026-11-14 21:18:41 +00:00
if ! bash " ${ REPO_ROOT } /scripts/orchestrator.sh" install; then
warn "skills: the Agent Orchestrator is down or partly installed; run 'bash scripts/orchestrator.sh install' once the reasons above are gone."
status = 1
fi
2026-11-06 22:20:06 +00:00
bash " ${ REPO_ROOT } /scripts/orchestrator.sh" runner || true
2026-11-06 08:28:04 +00:00
else
2026-11-06 22:20:06 +00:00
warn "skills: docker not found; skipped the Agent Orchestrator."
2026-11-06 08:28:04 +00:00
fi
2026-11-04 11:18:47 +01:00
log "skills: installing or updating the codebase-memory-mcp code graph for every detected agent"
if ! curl -fsSL --proto '=https' https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash; then
warn "skills: the codebase-memory-mcp installer failed; the code graph keeps its previous setup."
2026-11-04 00:15:07 +01:00
fi
2026-11-04 11:18:47 +01:00
if ( ulimit -c 0; codebase-memory-mcp config set auto_index true ) ; then
2026-11-03 23:24:36 +01:00
log "skills: auto-indexing every repository a session opens into the code graph"
else
2026-11-04 11:18:47 +01:00
warn "skills: codebase-memory-mcp is not runnable from PATH; the code graph stays off (see kvb-agent-optimize)."
2026-11-03 23:24:36 +01:00
fi
2026-11-04 17:48:42 +01:00
if command -v medusa & >/dev/null; then
log "skills: the MEDUSA security scanner is installed"
elif ! command -v pipx & >/dev/null; then
warn "skills: pipx not found; install the MEDUSA scanner with 'pip install --user medusa-security'. Until then kvb-check-security reviews by hand."
elif pipx install medusa-security; then
log "skills: installed the MEDUSA security scanner for kvb-check-security"
else
warn "skills: the MEDUSA install failed; kvb-check-security reviews by hand."
fi
2026-11-04 21:48:58 +01:00
lizard_pin = "lizard==1.24.1"
if command -v lizard & >/dev/null; then
log "skills: lizard is installed"
elif ! command -v pipx & >/dev/null; then
warn "skills: pipx not found; install lizard with 'pipx install ${ lizard_pin } '. Until then principles.py skips its complexity hits."
elif pipx install " ${ lizard_pin } " ; then
log "skills: installed ${ lizard_pin } for the principles.py complexity hits"
else
warn "skills: the lizard install failed; principles.py skips its complexity hits."
fi
jscpd_pin = "jscpd@5.4.2"
if command -v jscpd & >/dev/null; then
log "skills: jscpd is installed"
elif ! command -v npm & >/dev/null; then
2026-11-07 21:39:50 +00:00
warn "skills: npm not found; install jscpd with 'npm install --global --prefix ~/.local ${ jscpd_pin } '. Until then principles.py skips its clone hits."
elif npm install --global --prefix " ${ HOME } /.local" " ${ jscpd_pin } " ; then
log "skills: installed ${ jscpd_pin } into ~/.local/bin for the principles.py clone hits"
2026-11-04 21:48:58 +01:00
else
warn "skills: the jscpd install failed; principles.py skips its clone hits."
fi
2026-11-03 13:43:15 +01:00
fi
2026-07-10 11:23:51 +02:00
log "skills: done. Restart your agent to load the skills."
2026-11-14 21:18:41 +00:00
exit " ${ status } "