Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/psd401/psd-claude-pluginsnpx agentmods add skills/psd401/psd-claude-plugins/parentsquareWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/psd401/psd-claude-plugins/parentsquare)<a href="https://agentmods.dev/skills/psd401/psd-claude-plugins/parentsquare"><img src="https://agentmods.dev/badge/skills/psd401/psd-claude-plugins/parentsquare/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/psd401/psd-claude-plugins/parentsquare"><img src="https://agentmods.dev/badge/skills/psd401/psd-claude-plugins/parentsquare.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00135 | $0.01354 |
| Opus 5.5 | $0.00054 | $0.00542 |
| Sonnet 5.5 | $0.00027 | $0.00271 |
| Haiku 4.5 | $0.00014 | $0.00135 |
Grade A, and why
parentsquare scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 14d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.
ParentSquare CLI
A self-contained CLI for ParentSquare district/school data, generated with Printing Press from the live ParentSquare web app and hand-extended for PSD. Read-focused (rosters, directories, calendars, notification analytics); the only write is create-draft, which can only create an unsent draft.
Built for Peninsula School District (district
998), but every command takes a district/school/section ID, so it works for any district the authenticated account can access.
Setup (one-time)
1. Resolve the binary
The binary is not committed to the repo. Resolve it once — this downloads the prebuilt binary for your platform from the repo's GitHub Release (or builds it from cli/ if you have Go and no network):
BIN="$(bash scripts/ensure-binary.sh)" # run from this skill's directory
"$BIN" --version
Use "$BIN" for every command below. It caches under ~/.cache/parentsquare-pp-cli/, so this is a one-time cost.
2. Authenticate (Chrome cookie)
Auth is a ParentSquare session cookie read from Chrome. Install the cookie extractor once, then log in:
uv tool install pycookiecheat # one-time; the CLI shells out to it
# Be logged into www.parentsquare.com in Chrome, then:
"$BIN" auth login --chrome # approve the macOS Keychain prompt if shown
"$BIN" auth status # should print "Authenticated"
Re-run auth login --chrome if the session expires.
Global flags
Every command supports --json, --csv, --compact, --agent (all agent-friendly defaults), --dry-run, and --select <fields>. Framework commands sync (mirror to local SQLite), search, and analytics are also available.
Read commands
District (districts <cmd> <district_id>, PSD = 998)
| Command | Returns |
|---|---|
get-students.json 998 |
District student roster |
get-staff.json 998 |
District staff roster |
get-autocomplete 998 --query smith |
User search |
get-district-events 998 / get-school-events / get-group-events / get-class-events |
Calendars |
get-data-health-stats 998 |
Data-quality stats |
get-sync-info 998 |
SIS sync detail |
get-totals 998 |
District counts (students/staff/parents/sections) |
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- cli/.golangci.yml 147 B
- cli/.goreleaser.yaml 1.3 KB
- cli/AGENTS.md 2.4 KB
- cli/CHANGELOG.md 133 B
- cli/cmd/parentsquare-pp-cli/main.go 342 B
- cli/cmd/parentsquare-pp-mcp/main.go 2.1 KB
- cli/go.mod 1.7 KB
- cli/go.sum 16 KB
- cli/internal/cache/cache.go 1.7 KB
- cli/internal/cli/agent_context.go 8.1 KB
- cli/internal/cli/analytics.go 5.0 KB
- cli/internal/cli/auth.go 37 KB
- cli/internal/cli/channel_workflow.go 4.7 KB
- cli/internal/cli/data_source.go 22 KB
- cli/internal/cli/debug_fetch.go 1.1 KB
- cli/internal/cli/deliver.go 3.5 KB
- cli/internal/cli/districts_get_autocomplete.go 3.7 KB
- cli/internal/cli/districts_get_class_events.go 3.6 KB
- cli/internal/cli/districts_get_data_health_stats.go 3.2 KB
- cli/internal/cli/districts_get_district_events.go 3.6 KB
- cli/internal/cli/districts_get_group_events.go 3.6 KB
- cli/internal/cli/districts_get_school_events.go 3.6 KB
- cli/internal/cli/districts_get_staff.json.go 3.3 KB
- cli/internal/cli/districts_get_students.json.go 3.3 KB
- cli/internal/cli/districts_get_sync_info.go 3.1 KB
- cli/internal/cli/districts_get_totals.go 3.1 KB
- cli/internal/cli/districts.go 1.0 KB
- cli/internal/cli/doctor.go 21 KB
- cli/internal/cli/feedback.go 6.6 KB
- cli/internal/cli/helpers.go 58 KB
- cli/internal/cli/import.go 2.9 KB
- cli/internal/cli/notification_activity.go 5.8 KB
- cli/internal/cli/post_create_draft.go 4.3 KB
- cli/internal/cli/profile.go 10 KB
- cli/internal/cli/root_test.go 8.3 KB
- cli/internal/cli/root.go 11 KB
- cli/internal/cli/schools_get_directory.go 3.1 KB
- cli/internal/cli/schools_get_report_email_users.go 3.2 KB
- cli/internal/cli/schools_get_school_events.go 3.6 KB
- cli/internal/cli/schools.go 672 B
- cli/internal/cli/search.go 7.5 KB
- cli/internal/cli/sections_get_staff.go 3.1 KB
- cli/internal/cli/sections_get_students.go 3.1 KB
- cli/internal/cli/sections.go 612 B
- cli/internal/cli/sync_hint_test.go 5.2 KB
- cli/internal/cli/sync_hint.go 3.2 KB
- cli/internal/cli/sync_numeric_id_test.go 1.3 KB
- cli/internal/cli/sync.go 59 KB
- cli/internal/cli/tail.go 4.1 KB
- cli/internal/cli/version.go 725 B
- cli/internal/cli/which_test.go 3.8 KB
- cli/internal/cli/which.go 8.8 KB
- cli/internal/client/client_test.go 2.0 KB
- cli/internal/client/client_verify_short_circuit_test.go 6.2 KB
- cli/internal/client/client.go 33 KB
- cli/internal/cliutil/cliutil_test.go 26 KB
- cli/internal/cliutil/duration_test.go 1.6 KB
- cli/internal/cliutil/duration.go 1.5 KB
- cli/internal/cliutil/extractnumber_test.go 3.4 KB
- cli/internal/cliutil/extractnumber.go 2.4 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 14d ago Changed · -1 lines 66ad4ff99a59
- 1mo ago Changed b494a2c29313
- 2mo ago First seen · 108 lines · 135 tokens per session scan A b58f6c1e3489
parentsquare is a skill published in the GitHub repository psd401/psd-claude-plugins (2 stars, last pushed 9d ago), licensed MIT. It adds 135 tokens to every session and 1,354 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
hr-onboarding
A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".
book-mirror
Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates — a friend pointing out parallels, NOT a consultant rearranging the reader's…
exam-forecast
Analyze past exams from the same professor to surface patterns — subject weighting, recurring issue-spot traps, favored hypo types, policy-vs-doctrine mix — and forecast likely emphases for the upcoming exam. Use when the user says "what's on the exam", "analyze past exams", "predict the exam", or shares past exams.
lean-formalize
Develop and verify a mathematical proof in Lean, continue an incomplete Lean project, or audit whether it proves the original statement. Connect actual inputs to intermediate lemmas, assemble the target theorem, check its transitive axioms, and provide a reproducible handoff. Use when Lean is requested or a specific…
eli5
Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.
deck-course-module
A course or workshop slide template with persistent learning goals, teaching pages, multiple-choice self-tests, and a wrap-up.