Oak API

Oak API

Philosophy

Learner safety, age fit, and compliance come before product cleverness.

When To Use

• The task depends on Oak API subjects, units, lessons, quizzes, search, or endpoint mapping.
• The user wants Oak content turned into a learner-facing flow or implementation plan.
• A child-facing app needs age fit, attribution, API-key handling, and rate-limit reminders.

Avoid

• Do not create generic educational content with no Oak data dependency.
• Do not dump Oak lesson material verbatim.
• Do not imply Oak endorsement or skip licensing and rate-limit reminders.

Inputs

• User request and target repo or artifact.
• Evidence source such as files, diffs, issues, releases, or existing workflow state.
• Any safety, privacy, compliance, or approval constraints.

Outputs

• Schema-bound outputs include schema_version.
• Age-appropriate learning flow or endpoint map.
• Compliance checklist and attribution.
• Implementation guidance when requested.

Workflow

1. Collect age range, key stage, subject, learning goal, interaction style, and constraints.
2. Confirm no learner PII and restore age/compliance context if the task drifts.
3. Load only the archived Oak reference needed for the current request.
4. Map content into explain -> practice -> check flows.
5. Include required age, flow, compliance, attribution, pagination, and rate-limit markers when relevant.
6. Use authenticated fetch tooling only when explicitly needed and keep keys in environment variables.

Constraints

• Redact secrets, API keys, and learner details by default.
• Use Oak endpoint claims only from archived references or live verified docs.
• Do not log credentials or imply Oak endorsement.
• Fail fast with Missing inputs: age range, key stage, subject. when core context is absent.

Validation

• Run Plugin Eval and strict skill audit after editing this skill.
• Report exact validation commands and pass/fail outcomes.
• Fail fast: stop at the first failed gate, fix it, and rerun before continuing.

Anti-Patterns

• Do not create generic educational content with no Oak data dependency.
• Do not dump Oak lesson material verbatim.
• Do not imply Oak endorsement or skip licensing and rate-limit reminders.

Examples

• "Turn a KS2 maths unit into an Oak-backed practice flow."
• "Build the Oak flow, but age range and subject are missing."

Progressive Disclosure

• Archived full context: Infrastructure/references/deferred-skill-context/backend-platform-oak-api/.
• Load archived references only when the active workflow needs that exact detail.
• Keep the active path compact; do not remove important context for budget trimming.

See Also