feat(toggle): enable/disable non-marketplace tools via lib/toggle-external.sh
`claude plugin enable|disable` only toggles marketplace plugins. Tools living as symlinks (gstack per-skill entries, emil-design-eng, darwin-skill, find-skills) had no lever — users had to edit symlinks by hand. The new script moves symlinks in/out of skills-disabled/ so Claude Code stops or starts scanning them. Also removes the legacy global `skills/gstack` symlink that shadowed per-skill entries with a duplicate top-level "gstack" skill (same description as "browse"). gstack detection in detect-plugins.sh now probes an individual skill instead. plugin-advisor reads the new script's `list` command when gathering state and emits its `enable|disable` commands in recommendations. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
bastien
parent
618025cae2
commit
e389ac2f3c
3
.gitignore
vendored
3
.gitignore
vendored
@ -48,6 +48,9 @@ skills/emil-design-eng
|
||||
skills/darwin-skill
|
||||
skills/find-skills
|
||||
|
||||
# Staging area used by lib/toggle-external.sh when disabling a tool
|
||||
skills-disabled/
|
||||
|
||||
# Local project config (per-machine, not shared)
|
||||
.claude/
|
||||
|
||||
|
||||
@ -18,8 +18,10 @@ Detect active plugins and project signals. Recommend enable/disable. Apply compa
|
||||
# Claude Code plugins
|
||||
claude plugin list 2>/dev/null || echo "plugin-list-unavailable"
|
||||
|
||||
# GStack skills count (toggle CC plugin)
|
||||
ls $HOME/.claude/skills/gstack/skills/ 2>/dev/null | wc -l || echo "0"
|
||||
# External (non-marketplace) tools status — gstack, emil-design-eng,
|
||||
# darwin-skill, find-skills. Managed by lib/toggle-external.sh since
|
||||
# `claude plugin enable|disable` does not apply to them.
|
||||
bash "$HOME/.claude/lib/toggle-external.sh" list 2>/dev/null || echo "toggle-external-unavailable"
|
||||
|
||||
# Context7 CLI
|
||||
command -v ctx7 &>/dev/null && ctx7 --version 2>/dev/null | head -1 || echo "ctx7-not-installed"
|
||||
@ -271,6 +273,23 @@ RULE: IF `complex-arch` signal (multiple services, event bus, distributed system
|
||||
|
||||
---
|
||||
|
||||
## TOGGLING EXTERNAL TOOLS
|
||||
|
||||
Marketplace plugins toggle via `claude plugin enable|disable <name>@<marketplace>`.
|
||||
Non-marketplace tools (gstack per-skill symlinks, emil-design-eng, darwin-skill,
|
||||
find-skills) toggle via `bash $HOME/.claude/lib/toggle-external.sh enable|disable <tool>`.
|
||||
|
||||
When a recommendation flips the state of one of those tools, emit the exact
|
||||
command — never write files directly.
|
||||
|
||||
```
|
||||
# Enable gstack for a browser-QA signal:
|
||||
bash $HOME/.claude/lib/toggle-external.sh enable gstack
|
||||
|
||||
# Disable darwin-skill when passive cost is too high for a hotfix:
|
||||
bash $HOME/.claude/lib/toggle-external.sh disable darwin-skill
|
||||
```
|
||||
|
||||
## BLOCK if
|
||||
|
||||
- Superpowers not active → install: `claude plugin marketplace add obra/superpowers-marketplace && claude plugin install --scope user superpowers@superpowers-marketplace`
|
||||
|
||||
@ -33,7 +33,10 @@ detect_security_guidance() {
|
||||
# --- Toggle plugins ---
|
||||
|
||||
detect_gstack() {
|
||||
[ -d "$HOME/.claude/skills/gstack" ]
|
||||
# gstack is exposed via per-skill symlinks (browse, canary, qa, …);
|
||||
# the legacy top-level symlink was removed to avoid duplicate entries.
|
||||
# Detect by checking any of its individual skills.
|
||||
[ -L "$HOME/.claude/skills/browse" ] || [ -L "$HOME/.claude/skills/qa" ]
|
||||
}
|
||||
|
||||
detect_gsd() {
|
||||
|
||||
158
lib/toggle-external.sh
Executable file
158
lib/toggle-external.sh
Executable file
@ -0,0 +1,158 @@
|
||||
#!/usr/bin/env bash
|
||||
# ============================================================
|
||||
# lib/toggle-external.sh — enable/disable non-plugin tools
|
||||
#
|
||||
# Marketplace plugins are toggled by `claude plugin enable|disable`.
|
||||
# Tools distributed outside the marketplace (gstack submodule, emil
|
||||
# curl install, npx-installed skills) have no such lever — they live
|
||||
# as symlinks inside skills/. This script moves those symlinks
|
||||
# to/from skills-disabled/ so Claude Code stops/starts scanning them.
|
||||
#
|
||||
# Usage:
|
||||
# toggle-external.sh list
|
||||
# toggle-external.sh status <tool>
|
||||
# toggle-external.sh enable <tool>
|
||||
# toggle-external.sh disable <tool>
|
||||
#
|
||||
# Managed tools:
|
||||
# gstack — per-skill symlinks populated by gstack's own setup
|
||||
# emil-design-eng — single symlink → skills-external/emil-design-eng
|
||||
# darwin-skill — single symlink → ~/.agents/skills/darwin-skill
|
||||
# find-skills — single symlink → ~/.agents/skills/find-skills
|
||||
# ============================================================
|
||||
set -euo pipefail
|
||||
|
||||
REPO="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
SKILLS_DIR="$REPO/skills"
|
||||
DISABLED_DIR="$REPO/skills-disabled"
|
||||
|
||||
GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; NC='\033[0m'
|
||||
ok() { echo -e "${GREEN}✓${NC} $1"; }
|
||||
warn() { echo -e "${YELLOW}⚠${NC} $1"; }
|
||||
err() { echo -e "${RED}✗${NC} $1"; }
|
||||
|
||||
# All non-plugin tools this script can toggle.
|
||||
MANAGED_TOOLS=(gstack emil-design-eng darwin-skill find-skills)
|
||||
|
||||
# Prints the names (directory basenames) that belong to "gstack".
|
||||
# Source of truth: skills-external/gstack/*/SKILL.md. The repo's
|
||||
# skills/<name> symlinks are generated from these by gstack ./setup.
|
||||
gstack_skills() {
|
||||
local gstack_src="$REPO/skills-external/gstack"
|
||||
[ -d "$gstack_src" ] || return 0
|
||||
for d in "$gstack_src"/*/; do
|
||||
[ -f "${d}SKILL.md" ] || continue
|
||||
basename "$d"
|
||||
done
|
||||
}
|
||||
|
||||
# Prints "enabled" / "disabled" / "missing" for a tool.
|
||||
status_tool() {
|
||||
local tool="$1"
|
||||
case "$tool" in
|
||||
gstack)
|
||||
[ -d "$REPO/skills-external/gstack" ] || { echo "missing"; return; }
|
||||
while read -r name; do
|
||||
[ -e "$SKILLS_DIR/$name" ] && { echo "enabled"; return; }
|
||||
done < <(gstack_skills)
|
||||
echo "disabled"
|
||||
;;
|
||||
emil-design-eng)
|
||||
[ -d "$REPO/skills-external/emil-design-eng" ] || { echo "missing"; return; }
|
||||
[ -e "$SKILLS_DIR/emil-design-eng" ] && echo "enabled" || echo "disabled"
|
||||
;;
|
||||
darwin-skill|find-skills)
|
||||
[ -d "$HOME/.agents/skills/$tool" ] || { echo "missing"; return; }
|
||||
[ -e "$SKILLS_DIR/$tool" ] && echo "enabled" || echo "disabled"
|
||||
;;
|
||||
*)
|
||||
echo "unknown"; return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
disable_tool() {
|
||||
local tool="$1"
|
||||
mkdir -p "$DISABLED_DIR"
|
||||
case "$tool" in
|
||||
gstack)
|
||||
local moved=0
|
||||
while read -r name; do
|
||||
[ -e "$SKILLS_DIR/$name" ] || continue
|
||||
mv "$SKILLS_DIR/$name" "$DISABLED_DIR/gstack__$name"
|
||||
moved=$((moved + 1))
|
||||
done < <(gstack_skills)
|
||||
ok "gstack disabled ($moved symlinks moved)"
|
||||
;;
|
||||
emil-design-eng|darwin-skill|find-skills)
|
||||
if [ -e "$SKILLS_DIR/$tool" ]; then
|
||||
mv "$SKILLS_DIR/$tool" "$DISABLED_DIR/$tool"
|
||||
ok "$tool disabled"
|
||||
else
|
||||
warn "$tool already disabled"
|
||||
fi
|
||||
;;
|
||||
*) err "Unknown tool: $tool"; return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
enable_tool() {
|
||||
local tool="$1"
|
||||
case "$tool" in
|
||||
gstack)
|
||||
local moved=0
|
||||
if [ -d "$DISABLED_DIR" ]; then
|
||||
for entry in "$DISABLED_DIR"/gstack__*; do
|
||||
[ -e "$entry" ] || continue
|
||||
local name
|
||||
name="$(basename "$entry" | sed 's/^gstack__//')"
|
||||
mv "$entry" "$SKILLS_DIR/$name"
|
||||
moved=$((moved + 1))
|
||||
done
|
||||
fi
|
||||
if [ "$moved" -eq 0 ]; then
|
||||
warn "gstack was not disabled — re-run gstack setup to (re)create symlinks"
|
||||
else
|
||||
ok "gstack enabled ($moved symlinks restored)"
|
||||
fi
|
||||
;;
|
||||
emil-design-eng|darwin-skill|find-skills)
|
||||
if [ -e "$DISABLED_DIR/$tool" ]; then
|
||||
mv "$DISABLED_DIR/$tool" "$SKILLS_DIR/$tool"
|
||||
ok "$tool enabled"
|
||||
elif [ -e "$SKILLS_DIR/$tool" ]; then
|
||||
warn "$tool already enabled"
|
||||
else
|
||||
err "$tool not installed — run: make plugin"
|
||||
return 1
|
||||
fi
|
||||
;;
|
||||
*) err "Unknown tool: $tool"; return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
list_all() {
|
||||
printf "%-20s %s\n" "TOOL" "STATUS"
|
||||
printf "%-20s %s\n" "----" "------"
|
||||
for t in "${MANAGED_TOOLS[@]}"; do
|
||||
printf "%-20s %s\n" "$t" "$(status_tool "$t")"
|
||||
done
|
||||
}
|
||||
|
||||
usage() {
|
||||
sed -n '3,23p' "$0" | sed 's/^# \?//'
|
||||
exit "${1:-0}"
|
||||
}
|
||||
|
||||
main() {
|
||||
local cmd="${1:-}"
|
||||
case "$cmd" in
|
||||
list) list_all ;;
|
||||
status) [ $# -ge 2 ] || usage 1; status_tool "$2" ;;
|
||||
enable) [ $# -ge 2 ] || usage 1; enable_tool "$2" ;;
|
||||
disable) [ $# -ge 2 ] || usage 1; disable_tool "$2" ;;
|
||||
""|-h|--help|help) usage 0 ;;
|
||||
*) err "Unknown command: $cmd"; usage 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
main "$@"
|
||||
18
link.sh
18
link.sh
@ -35,14 +35,18 @@ for item in hooks agents skills lib templates; do
|
||||
CHANGED=$((CHANGED + 1))
|
||||
done
|
||||
|
||||
if [ -d "$REPO/skills-external/gstack" ]; then
|
||||
if [ -L "$CLAUDE/skills/gstack" ] && [ "$(readlink "$CLAUDE/skills/gstack")" = "$REPO/skills-external/gstack" ]; then
|
||||
: # already correct
|
||||
else
|
||||
ln -sf "$REPO/skills-external/gstack" "$CLAUDE/skills/gstack"
|
||||
# GStack is exposed via per-skill symlinks under skills/ (browse,
|
||||
# canary, autoplan, design-review, …) created by gstack's own
|
||||
# `./setup`. A global `skills/gstack -> skills-external/gstack/`
|
||||
# symlink duplicated the top-level gstack SKILL.md alongside those
|
||||
# individual skills, producing two entries with the same description
|
||||
# ("Fast headless browser for QA testing…"). Remove any stale global
|
||||
# link — only per-skill entries remain.
|
||||
if [ -L "$REPO/skills/gstack" ] || [ -L "$CLAUDE/skills/gstack" ]; then
|
||||
rm -f "$REPO/skills/gstack" "$CLAUDE/skills/gstack"
|
||||
CHANGED=$((CHANGED + 1))
|
||||
fi
|
||||
else
|
||||
fi
|
||||
if [ ! -d "$REPO/skills-external/gstack" ]; then
|
||||
echo "⚠️ GStack submodule not found — run: git submodule update --init"
|
||||
fi
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user