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
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-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-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-13 10:45:49 +00:00
install -d -m 0700 " ${ HOME } /.local/state/agents-council"
2026-11-03 13:43:15 +01:00
if command -v systemctl & >/dev/null && systemctl --user show-environment & >/dev/null; 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-06 22:20:06 +00:00
bash " ${ REPO_ROOT } /scripts/orchestrator.sh" install
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-14 21:25:12 +00:00
if ( ulimit -c 0; codebase-memory-mcp config set auto_index false ) ; then
log "skills: daemon auto_index off; the kvb-agent-optimize graph.py hook indexes every git root a session touches, the session root included, through its size and memory gates"
2026-11-03 23:24:36 +01:00
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-14 21:25:12 +00:00
graph_config = " ${ XDG_CONFIG_HOME :- ${ HOME } /.config } /kvb-code-graph/config.json"
graph_settings = ""
if [[ -f " ${ graph_config } " ]] ; then
graph_settings = " $( <" ${ graph_config } " ) "
fi
if [[ " ${ graph_settings } " != *'"queue_file_threshold"' * || " ${ graph_settings } " != *'"queue_task"' * ]] ; then
warn "skills: kvb-code-graph: no config at ${ graph_config } with queue_file_threshold and queue_task; the graph.py hook indexes nothing until the operator sets both (see kvb-agent-optimize)."
fi
if command -v systemctl & >/dev/null && systemctl --user show-environment & >/dev/null && [[ -x " ${ HOME } /.local/bin/codebase-memory-mcp" ]] ; then
log "skills: enabling kvb-code-graph.service, which keeps a permanent codebase-memory-mcp daemon so every graph stays watched"
mkdir -p " ${ HOME } /.config/systemd/user"
cp -f " ${ REPO_ROOT } /skills/kvb-agent-optimize/systemd/kvb-code-graph.service" " ${ HOME } /.config/systemd/user/"
systemctl --user daemon-reload
systemctl --user try-restart kvb-code-graph.service || true
if ! systemctl --user enable --now kvb-code-graph.service; then
systemctl --user enable kvb-code-graph.service || true
log "skills: kvb-code-graph.service enabled; it did not start now and takes effect at next login."
fi
else
warn "skills: no systemd user session or no ~/.local/bin/codebase-memory-mcp; graphs keep their watch only while a session runs."
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."