Intschool
tiger20240331/intschool
One-page IntSchool radar report card skill for any subject or role: course radar with task drill-down, weekly triage queue, class heat map, parent drafts.
インストール
dsh plugin --profile web add github:tiger20240331/intschoolREADME
Radar on Intschool_Skill_v1.1
A DeepSeek Harness skill bundle that builds a one-page IntSchool radar report card for any subject teacher, tutor, coordinator or administrator — plus the read-only collector, renderer, illustrated guide and configurable defaults it needs.
- Students. Course-level radar (high school axes are course names, so AP Precalculus for G10 and G11 are separate axes; middle school uses subject + level), score-metric switch, class average and percentile (only with ≥5 peers), per-task drill-down with task name, type, description and attachments.
- Weekly reading. Attribution of the last two weeks, stability σ, a forecast interval (a range, not a promise), and the score profile by task type.
- Evidence. Top 3 / Bottom 3 over four weeks and Missing 3 over the last week, expandable to the whole term.
- Teacher views. A weekly triage queue of six students, a class × task-type heat map, and communication coverage (who has had no positive note for three weeks).
- Communication. Bilingual parent drafts (copy or mail only — never sent), a printable student self-check, and a parent view without peer comparison.
Live demo (invitation only)
A published copy of what the kit produces — same layout, learner names replaced by
Student 01…, no family contact details:
https://tiger20240331.github.io/Intschool/
The root is a gate page and the report itself is stored encrypted: one access code per invited
parent (kit/tools/make_invites.py) is the only way to decrypt it. Reproduce it with
kit/8_publish_web.command — see Publishing below.
Install
- From the plugin market: add the index that lists this bundle, then install it from Discover.
- From a local directory: Plugins → Add plugin and choose this folder.
- From npm:
npm install radar-on-intschool-skillin the profile (the bundle is a normal DSH bundle).
The bundle registers the skill radar-on-intschool and its kit. No DSH dependency is declared:
the plugin only reads its own files at activation.
Use
Ask the agent for a radar report card, a weekly follow-up list, a class heat map or parent-meeting
material. The skill asks four questions (account and role, scope, score metric, audience), then runs
kit/tools/collect.py and kit/tools/render_radar.py and opens kit/output/Radar_<name>.html.
Configure
kit/config.json ships with an empty default_class, so the class dropdown opens on the teacher's
largest course. Set it to a course name (for example "G7 Biology CPA") to pin the default.
exclude_keywords, include_course_ids and exclude_course_ids adjust what the collector treats
as a teaching course.
Update
Install the newer version of radar-on-intschool-skill (same package name); the skill body and kit
update together. Keep your kit/config.json and kit/token.txt — they are yours, not the author's.
Publishing
8_publish_web.command (default) builds an anonymised copy, pushes it to GitHub Pages and mints one
access code per parent email. ./8_publish_web.command public publishes it openly and pings IndexNow;
./8_publish_web.command full publishes real data only after typing PUBLISH.
The published report is AES-GCM encrypted; each parent's 64-bit code unwraps the key via PBKDF2 (200k iterations), so a copy of the file alone is useless. Republishing rotates the key and retires older codes. Keep the public copy anonymised all the same.
Privacy and limits
- Read-only IntSchool access; nothing is written back to the school system.
- The token stays in
kit/token.txton the teacher's machine; never share or log it. - Reports contain student names and grades: share only with the teacher or their named audience.
- Missing work is counted only for tasks due in the last seven days; a gradebook with many unmarked tasks is treated as a data problem, not as missing work.
- Predictions are intervals; class averages and percentiles require at least five peers.
- Parent messages are drafts only; the send button stays with the teacher.
Licence
MIT. Copy, change and re-share — keep the copyright notice.