managing-sc-packages

Managing Synaptic Canvas Packages

Use this skill to manage Synaptic Canvas packages on this machine or in the current repo.

Agent Delegation

This skill delegates to specialized agents via the Task tool:

Operation	Agent	Returns
List	sc-packages-list	JSON: packages [{ name, description, installable_scopes, installed }]
Install	sc-package-install	JSON: success, scope, dest
Uninstall	sc-package-uninstall	JSON: success, scope, dest
Docs	sc-package-docs	JSON: readme_path, size_bytes

Inputs / Flags

• --list → call sc-packages-list.
• --install <package> → require --local/--project or --global/--user; if missing, ask the user. If the package is local-only, force --local.
• --uninstall <package> → same scope logic as install.
• --docs <package> (alias --doc) → call sc-package-docs to load and present the package README.

Conventions

• Local scope: current repository's .claude directory.
• Project scope: alias for local.
• User scope: ~/.claude unless USER_CLAUDE_DIR is set.
• Global scope: ~/.claude unless GLOBAL_CLAUDE_DIR is set.
• The agents will detect the repo toplevel via git rev-parse --show-toplevel.
• The agents call the Synaptic Canvas installer at <SC_REPO_PATH>/tools/sc-install.py (default resolved from SC_REPO_PATH or the repo root).

Safety

• Respect package metadata: if a package manifest declares install.scope: local-only, block global installation.
• Return only fenced JSON from agents; present tables and prompts in this skill.