From hoopit-onboarding
Set up a brand-new machine for the Hoopit Django API — install tooling (gh, mise/Python 3.14, uv, Docker, pre-commit, Sentry CLI, acli, AWS CLI), clone hoopit/api as a sibling of the skills repo, bootstrap deps + supporting services (Postgres/Redis/stripe-mock), migrate, run the server, and run tests. Use when a developer wants to onboard to the API, set up their api/backend dev environment, or asks how to get the Django API running locally.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hoopit-onboarding:setup-apiThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Drive a new machine to a working `api` (Django) checkout. The detailed,
Drive a new machine to a working api (Django) checkout. The detailed,
platform-aware walkthrough lives in ONBOARDING.md — read it and
follow it step by step. This file is the orchestration contract.
sudo/admin rights, browser
logins (GitHub, Atlassian, AWS), Docker Desktop install.This skill runs from inside the skills repo. Clone api as a sibling of
skills, not inside it:
# from the skills repo root
gh repo clone hoopit/api ../api
cd ../api
This yields …/api next to …/skills. Run the rest of the bootstrap from inside
../api.
gh (+auth), mise (+Python 3.14), uv, Docker,
sentry, acli (+auth), and aws (optional, for staging/prod).uv sync, pre-commit install
(commit + push + post-checkout hooks).local.env expects it
on 127.0.0.1:5435), plus optional Redis + stripe-mock for Celery/payments.manage-local.py migrate, then runserver on 0.0.0.0:8080.uv run pytest.Finish by walking the Final verification checklist in ONBOARDING.md and reporting any unchecked item.
uv is the package manager. Use uv run … / uv sync, not bare pip.DOTENV=local.env (or use the ./manage-local.py
wrapper, which presets DJANGO_SETTINGS_MODULE and DOTENV).ruff format ., lint/import-order with ruff check ..aws login session for the hoopit-{staging,prod}-developer
role.npx claudepluginhub hoopit/skills --plugin hoopit-onboardingCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.