resilio-app: Skill for Claude Code

Complete Setup (macOS only)

Scope

This skill performs safe environment setup for beginners on macOS only.

If the platform is not macOS, stop and explain that non-macOS setup is deferred in this iteration.

Python support target: >=3.11,<4.0.

Safety Rules (hard)

Never do these during onboarding:

• Replace or delete system Python binaries/symlinks
• Change OS-managed default Python interpreter mapping
• Require global shell aliases for python3
• Use sudo pip
• Advance to the next phase before validation passes

Always prefer explicit interpreter usage (python3.12 or python3.11) over system mutation.

Workflow Checklist

Copy and update this checklist while running setup:

Setup Progress:
- [ ] Phase 1: Detection gates passed
- [ ] Phase 2: Python available (>=3.11)
- [ ] Phase 3: Package installed and `resilio` runnable
- [ ] Phase 4: Config initialized
- [ ] Phase 5: Final verification + handoff

Phase 1: Detection Gates (must run in order)

Gate 1: Repo root

if [ ! -f pyproject.toml ] || [ ! -d resilio ]; then
  echo "Not in repo root. cd into resilio and retry."
  exit 1
fi

Gate 2: Platform

uname

• Darwin -> continue
• anything else -> stop with defer message

Gate 3: Interpreter selection (safe)

PYTHON_CMD=""
if command -v python3 >/dev/null 2>&1 && python3 -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)'; then
  PYTHON_CMD="python3"
elif command -v python3.12 >/dev/null 2>&1; then
  PYTHON_CMD="python3.12"
elif command -v python3.11 >/dev/null 2>&1; then
  PYTHON_CMD="python3.11"
fi

• PYTHON_CMD set -> Python gate passed
• empty -> run Phase 2

Gate 4: Install path discovery

poetry --version >/dev/null 2>&1

• success -> Poetry path available
• failure -> venv path

Gate 5: Package runnable check

PACKAGE_READY=false
if command -v resilio >/dev/null 2>&1; then
  resilio --help >/dev/null 2>&1 && PACKAGE_READY=true
elif poetry --version >/dev/null 2>&1; then
  poetry run resilio --help >/dev/null 2>&1 && PACKAGE_READY=true
fi