Skip to content

forcedotcom/sf-skills / plugins/builder/education-cloud/skills/education-cloud-course-catalog-migrate

education-cloud-course-catalog-migrate

Verified

Use this skill to migrate course catalog data from external sources (CSV, PDF, website) and bulk-create Learning and LearningCourse records in Education Cloud. Triggers when a user wants to import courses, parse course catalog documents, or set up a course catalog for an academic term. Handles multi-source data ingestion, intelligent interpretation of course structures (lecture+lab linked courses via IsLinkedOnly flag, credit hours, course types), batch creation via sObject REST API, data quality validation, conflict resolution for existing courses, and gap identification. Explains what's missing (descriptions, types) and requests additional sources. Pauses for clarification on multi-component courses and conflicting data. DO NOT TRIGGER for creating individual Learning Course records manually, for creating Learning Programs (different workflow), or for enrollment/registration workflows.

FileKindSize
SKILL.mdskill md21.3 KB
references/gotchas-detail.mdmarkdown3.9 KB
references/gotchas.mdmarkdown2.0 KB
references/large-catalog-handling.mdmarkdown6.8 KB
scripts/batch_courses.pyexecutablescript915 B
scripts/detect_linked_courses.pyexecutablescript1.5 KB
scripts/detect_modality_variants.pyexecutablescript1.4 KB
scripts/resolve_api_version.pyexecutablescript1.2 KB
scripts/split_course_code.pyexecutablescript1.0 KB
scripts/validate_completeness.pyexecutablescript1.9 KB

references/gotchas.md

View on GitHub
# Gotchas

| Issue | Resolution |
|-------|------------|
| CSV column headers don't match expected names | Infer column mapping from context (e.g., "Code" → course code, split via `scripts/split_course_code.py` into SubjectAbbreviation/CourseNumber — not CipCode, see step 8/9; "Title" → Name, "Credits" → Duration) |
| Credit hours stored as "3.0 credits" instead of numeric | Parse and extract numeric value, set DurationUnit = "Credit Hours" |
| Course codes have inconsistent formatting | Normalize before creating (e.g., "BIO 201" → "BIO-201", "bio-201" → "BIO-201") |
| PDF has multi-column layout | Text extraction may be out of order — validate course sequence makes sense |
| Website has pagination | Fetch all pages before parsing (detect "next page" links and loop) |
| Missing Business Account ID | Ask the user to supply the Account Id (ProviderId), read a known Account with `GET /services/data/vXX.X/sobjects/Account/<id>`, or look it up by name with a SOQL `/query` (confirmed routable via headless-360) |
| Course type values don't match Education Cloud picklist | Map common values (e.g., "Lec" → "Lecture", "Laboratory" → "Lab", "Drill" → "Drill", "Recitation" → "Recitation") |
| Composite API returns partial success | Check response for each record — some may fail while others succeed (allOrNone = false) |
| Two-object create pattern complexity | Create Learning records first (store IDs), then create LearningCourse records with LearningId lookups |
| Source value not in describe's picklist list (e.g. DurationUnit = "Program Points") | `restrictedPicklist: true` means only active-today values are valid, not that the set is closed — offer the user the option to add the new picklist value via metadata, in addition to remapping or placeholder options. Do not assume it's a dead end |

More edge-case gotchas (linked-course mapping, enrollment conflicts, sharing defaults, describe caching, ambiguous subject codes, post-write visibility, record-type-scoped picklists, shell-out stalls): see `references/gotchas-detail.md`.
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