canvas-lmslisted
Install: claude install-skill timdrichards/canvas-lms-skill
# Canvas LMS
A skill for working with the Canvas LMS API through `scripts/canvas.py`, a helper
that handles authentication, pagination, rate limiting, and encoding so you can
focus on choosing the right endpoint and payload.
## Configuration
Three environment variables. Check they are set before doing anything else; if
`CANVAS_BASE_URL` or `CANVAS_API_TOKEN` is missing, stop and ask the user.
```bash
export CANVAS_BASE_URL=https://school.instructure.com # no trailing slash
export CANVAS_API_TOKEN=<token> # Canvas: Account > Settings > New Access Token
export CANVAS_COURSE_ID=12345 # optional default; enables :course in paths
```
Suggest a gitignored `.env` file if the user works in a repo. For risky or
experimental work, suggest the beta instance (`https://<school>.beta.instructure.com`),
which is refreshed from production weekly, so mistakes there do not touch the
live course. Tokens are instance specific: a production token does not work on
beta until beta refreshes after the token was created.
## The helper script
Always use `scripts/canvas.py` instead of raw curl. It follows pagination Link
headers, backs off on rate limits, retries transient errors, and substitutes
`:course` with `CANVAS_COURSE_ID`.
```bash
# Read (use --all for any list; Canvas defaults to 10 items per page)
python3 scripts/canvas.py get /courses/:course/assignments --all
python3 scripts/canvas.py get /courses/:course/users --all --param "enrollment_type[]=student"
# Create / update (