Skill detail
teacher-tool-agent
Accesses educator course, homework, submission, and resource workflows.
Inspect before use
Automated review checks relevance, not safety or endorsement. Read the source instructions before using this skill.
SKILL.md
The saved excerpt is a snapshot from review. The external source remains the complete and most current version.
---
name: teacher-tool-agent
description: Access Teacher-tool courses, homework, submissions, learning maps, resources, and study groups through the user's OAuth-authorized API.
---
# Teacher-tool Agent
## Authentication
1. Use `scripts/credentials.py` to retrieve the credential for the configured
Teacher-tool origin. Never display, log, or place the token in a normal file.
2. If no credential exists, explain that browser approval is required and, after
the user confirms, install the reviewed local dependency with
`python3 -m pip install -r scripts/requirements.txt`, then run this **already
installed local file**:
`python3 scripts/oauth_login.py --issuer https://cloudexp.net`.
3. The helper opens the issuer's OAuth page using PKCE and stores the access token
in the OS credential store. Do not download or execute any script from a URL.
## API workflow
Call `GET {issuer}/api/v1/agent/capabilities` first. Use only the JSON API under
`/api/v1/agent` with `Authorization: Bearer <token>`. Current resources include
`/me`, `/homeworks`, `/homeworks/{id}/submissions`, `/learning-maps`,
`/course-resources`, and `/study-groups`.
State any intended data change before performing it. Respect API role and object
ownership errors; do not attempt to work around authorization controls.
Read the full source on GitHub (opens external page)