CASE 1EdTech Skill Pack

Installable Pack

Primary file

`SKILL.md`

The manifest tells an agent when to use the pack, how to authenticate, which endpoints to call first, and where the surface boundary is.

Open hosted SKILL.md

Agent metadata

`agents/openai.yaml`

Codex-facing display metadata for skill discovery. It is metadata only and carries no API logic or copied CASE facts.

Open hosted metadata

Hosted folder

`/pack`

The hosted pack index mirrors the local skill and lists every file a cold agent must fetch before using it. /install remains as a compatibility mirror.

Open hosted pack index

agents/openai.yamlCodex-facing UI metadata for the installable skill folder. references/worked-example.mdEnd-to-end live API snapshot and Alignment proof. references/app-build-protocol.mdProtocol for building a standards-browser app. references/auth-and-headers.mdAuth, pagination, errors, and ETag behavior. references/leak-check.mdBinary checklist for surface-owned logic leaks. checks/case_surface_check.shRunnable API-only check against the platform package-export answer key.

export CASE_SKILL_PACK_URL="https://platform3-andymontgomery-9773s-projects.vercel.app/case/1edtech/skill_pack"
mkdir -p case-1edtech-standards-browser/agents case-1edtech-standards-browser/references case-1edtech-standards-browser/checks
curl -fsSL "$CASE_SKILL_PACK_URL/pack/SKILL.md" \
  -o case-1edtech-standards-browser/SKILL.md
curl -fsSL "$CASE_SKILL_PACK_URL/pack/agents/openai.yaml" \
  -o case-1edtech-standards-browser/agents/openai.yaml
for file in worked-example app-build-protocol auth-and-headers leak-check; do
  curl -fsSL "$CASE_SKILL_PACK_URL/pack/references/$file.md" \
    -o "case-1edtech-standards-browser/references/$file.md"
done
curl -fsSL "$CASE_SKILL_PACK_URL/pack/checks/case_surface_check.sh" \
  -o case-1edtech-standards-browser/checks/case_surface_check.sh
chmod +x case-1edtech-standards-browser/checks/case_surface_check.sh

Canonical Sources

Use	Canonical URL	Why it matters
Customer contract	CASE customer website	Defines quickstart, auth, endpoints, errors, concurrency, and Alignment behavior.
Field meaning	CASE data dictionary	Documents table and field meaning, invalid values, ranges, source labels, and ITD provenance.
Decision source	CASE architecture	Pins CASE decisions including Alignment, ETag/If-Match, idempotency, and package import/export.
Live API	Implementation API	The only data layer the pack calls.
External spec	1EdTech CASE 1.1	Official CASE specification; platform3 docs define the approved TimeBack surface over it.
External landing	1EdTech CASE standards landing	Public standards entry point for CASE context; platform3 docs remain the approved surface contract.

Agent Workflow

1. Read DocsStart with the customer website and data dictionary for each resource touched.

2. AuthUse demo mint for demo or operator token for real tenants.

3. BrowseCall CFDocuments, CFItems, CFItemAssociations, and CFAssociations.

4. AlignStore external IDs through Alignment only.

5. EvidenceReturn endpoints, tenant mode, IDs, and response snippets.

Surface Calls

Read

Browse the CASE graph

GET /ims/case/v1p1/CFDocuments
GET /ims/case/v1p1/CFItems?CFDocumentURI=...
GET /ims/case/v1p1/CFItemAssociations/{sourcedId}
GET /ims/case/v1p1/CFAssociations?...

Write

Persist through the surface

POST /ims/case/v1p1/Alignments
GET /ims/case/v1p1/Alignments?externalSystem=...&externalId=...
POST /ims/case/v1p1/CFPackages
GET /ims/case/v1p1/CFPackages/{sourcedId}

Headers

Protect writes

Authorization: Bearer $CASE_TOKEN
Idempotency-Key on retryable writes.
If-Match on PUT, PATCH, DELETE.
X-Case-ETag after successful PUT/PATCH.

Worked Example

The pack regenerates a standards-browser snapshot and Alignment proof with live surface calls only. The full sequence is in references/worked-example.md.

export CASE_BASE_URL="https://platform3-andymontgomery-9773s-projects.vercel.app/case/1edtech/implementation/api"
export CASE_TOKEN="$(curl -s -X POST "$CASE_BASE_URL/dev/mint?tenantId=demo" | jq -r '.token')"

curl -s "$CASE_BASE_URL/ims/case/v1p1/CFDocuments/3ea5c35f-5b3f-5e4d-905a-483c134316ec" \
  -H "Authorization: Bearer $CASE_TOKEN"

curl -s "$CASE_BASE_URL/ims/case/v1p1/CFItems?CFDocumentURI=https%3A%2F%2Falpha.school%2Fcase%2Fcfdocuments%2F3ea5c35f-5b3f-5e4d-905a-483c134316ec&limit=25" \
  -H "Authorization: Bearer $CASE_TOKEN"

The example then creates an Alignment for a demo lesson, verifies it by externalSystem and externalId, and formats a short Markdown report from the API responses.

Runnable Check

checks/case_surface_check.sh proves the pack against the platform by calling the live surface. It reads one CFDocument, lists its CFItems by CFDocumentURI, reads a target item's association set, fetches CFPackages/{sourcedId} as the platform answer key, and verifies the browser calls reproduce that answer.

cd case-1edtech-standards-browser
./checks/case_surface_check.sh

# Optional write evidence, only when the job needs Alignment proof:
./checks/case_surface_check.sh --write-alignment

The check emits JSON evidence and carries no standards catalog, CASE parser, package validator, graph-repair rule, copied enum table, or publisher URI inference.

Logic Leak Check

Pass

The pack does

Call the live CASE implementation.
Point to the hosted customer website and data dictionary.
Use Alignment for external IDs.
Use Idempotency-Key, If-Match, and X-Case-ETag as documented.
Expose response evidence for review.

Stop

The pack refuses to carry

Local CASE schema parsing or package validation.
Copied association-type or problem-code tables.
Publisher hostname or code-family inference.
Graph dedup, repair, or membership inference.
External IDs inside CFAssociation, CFItem extensions, or CFPackage export.

If an app needs the refused logic to complete the documented job, the surface leaked. The pack tells the agent to report the exact endpoint, request, response, and earliest upstream deliverable that must change.

Quality Bar

This skill pack targets a discerning AI coding agent comparing it against Anthropic's public skills catalog: a self-contained SKILL.md folder with referenced files, install commands, credential bootstrap, worked live examples, app-build boundaries, and a binary leak check.

The pack should pass because it makes the agent faster and safer than generic raw HTTP plus model memory while keeping all surface-owned behavior in the API.