randlee/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.