# R2 Notebooklm Artifact Portal

> Use when publishing, validating, or debugging public NotebookLM artifacts hosted on Cloudflare R2, including artifact inventories, public URLs, MIME types, cache headers, audio/video playback, and notebook visibility claims.

- Skill: `sheshiyer/r2-notebooklm-artifact-portal` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sheshiyer/r2-notebooklm-artifact-portal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sheshiyer/r2-notebooklm-artifact-portal/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Sheshiyer (https://skillmd.com/u/sheshiyer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sheshiyer/r2-notebooklm-artifact-portal

---


# R2 NotebookLM Artifact Portal

## Purpose

Validate that NotebookLM artifacts are real, public, correctly typed, cacheable, and usable from an Astro/wiki/press-kit portal.

## Required Routing

- Use `notebooklm` before claiming a notebook exists, sources are attached, or artifacts were generated.
- Use `cloudflare`, `wrangler`, or `cloudflare-manager` for Cloudflare account/bucket operations.
- Use this skill for the portal contract: public URLs, MIME, cache headers, inventory, embed/playback, and reader-facing labels.

## Artifact Contract

Every portal artifact should have:

- Stable `id`
- Reader-facing `title`
- Public `href`
- `type` such as `report`, `infographic`, `deck`, `audio`, `video`, `table`, `flashcard`, `quiz`, or `mindMap`
- Expected extension and MIME
- Optional `thumbnail`
- Reader-facing description

## MIME Expectations

| Extension | Expected content type contains |
| --- | --- |
| `.mp3` | `audio/` |
| `.mp4` | `video/` |
| `.pdf` | `application/pdf` |
| `.png` | `image/png` |
| `.csv` | `text/csv` or `application/octet-stream` |
| `.json` | `application/json` or `application/octet-stream` |
| `.md` | `text/`, `markdown`, or `application/octet-stream` |

## Validation Workflow

1. Check live NotebookLM visibility with `notebooklm list --json` or explicit notebook ID.
2. Check local artifact inventory, usually `src/data/artifacts.json`.
3. HEAD every remote artifact URL.
4. Fail on 4xx/5xx, missing content type, incompatible MIME, or missing cache headers for large immutable assets.
5. Verify audio/video pages use playable embeds or clearly labeled direct links.
6. Verify public copy says `Source artifact`, `Open artifact`, or `Download`, not `Raw artifact path`.

## Reader-Facing Copy Rules

- Say `NotebookLM companion artifact`, not `raw output`.
- Say `R2-hosted source artifact`, not local file path.
- Do not expose bucket internals unless the URL itself is the public contract.
- Do not claim NotebookLM flow completion without live account verification or an explicit local-only caveat.