Skip to content

forcedotcom/sf-skills / plugins/builder/education-cloud/skills/education-cloud-multi-campus-configure

education-cloud-multi-campus-configure

Verified

Use this skill when a Salesforce Administrator needs to create OR maintain an institutional hierarchy for Education Cloud by parsing organizational structure from a PDF, URL, text, or CSV. On a first run it creates System, Campus, College, and Department Account records linked via ParentId plus 1:1 Business Profile records. On later runs it reconciles the org's existing hierarchy against the desired structure and applies only the delta — adding new units, renaming, or moving a node under a different parent — never recreating what exists. TRIGGER when the user wants to set up, configure, build, update, restructure, or reorganize a multi-campus structure, institutional hierarchy, or account hierarchy with business profiles; or add, rename, or move a campus, college, or department. DO NOT TRIGGER for single-campus flat setups without hierarchy levels, one-off manual account creation, or non-Education-Cloud account management.

references/gotchas.md

View on GitHub
# Gotchas

| Issue | Resolution |
|-------|------------|
| Rename vs. delete-plus-add is indistinguishable from a bare desired tree | Only treat a change as RENAME/MOVE when the user names it explicitly; otherwise an absent node is CREATE and an extra node is EXTRA (report, don't delete) |
| Update run recreates everything (duplicates) | Ensure Step 4 detected update mode and Step 5 loaded `existingTree`; a missing root Id defaults to new setup — confirm mode with the user |
| `ChildAccounts` relationship returns partial/paged results | Follow `nextRecordsUrl`/paging if present; if the relationship is unavailable, fall back to a SOQL `/query` with `WHERE ParentId = ...` (confirmed routable), or ask the user to paste current node Ids |
| API rate limit during Business Profile creation | Retry failed records after 2-second delay; print which records succeeded vs. failed |
| Ambiguous college-to-campus mapping in parsed text | Ask user: "Which campus does [College name] belong to?" before creating College Account |
| Duplicate names across campuses (e.g., "School of Arts & Sciences" on multiple campuses) | Append campus name to college name: "School of Arts & Sciences (Main Campus)" |
| PDF parsing extracts noise (headers, footers, page numbers) | Filter lines matching common noise patterns before parsing hierarchy; see `references/hierarchy_parsing_rules.md` |
| User uploads flattened list without parent relationships stated | Ask user to clarify structure: "I see these names — please describe which items are campuses, colleges, and departments" |
| BusinessProfile creation fails with "AccountId field not found" | User's org may not have Education Cloud provisioned; check access prerequisites returned error |
| User expects a stored materialized-path field to read back | There is none — build the path on demand by GET-ing the Account and walking its ParentId chain to the System root, joining Names with ` / ` |
| Requested URL is blocked/unreachable during Step 1 | Do not silently substitute another source (e.g. a research agent pulling from Wikipedia) — stop and ask the user for a PDF, CSV, or pasted text from the institution's own site |
| User wants `InstitutionType` set on a Business Profile for a non-K-12/higher-ed institution (vocational, allied health, satellite/extension) | `InstitutionType` is a managed, restricted picklist (typically `Public`/`Private`/`Charter` only) — cannot be extended; tell the user upfront and offer `Description` as the only workaround field |
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall