Scaffold a vignette catalog

rest

duckdb

pooch

files

Workflow

1. Inspect the target. For a new catalog, require an absent or empty directory. For an existing repository, preserve its files and use

   --adopt

   .
2. Generate the minimum structure:
   bash

   <skill-dir>/scripts/scaffold.py <target> --name <name> --surface <surface>
   # Existing repository:
   <skill-dir>/scripts/scaffold.py <target> --name <name> --surface <surface> --adopt

   The script copies real assets rather than asking the model to reproduce templates from prose.
3. Replace the deliberate

   NotImplementedError

   in

   notebooks/nb01_orientation.py

   with one bounded call that reaches the actual dataset. Put reusable access logic in a top-level

   @app.function

   , and declare its dependencies and versions in the notebook's PEP 723 block.
4. Fill the dataset-specific fields in

   catalog.toml

   : description, upstream version, cache, caveats, auth, helper names, and what the orientation notebook demonstrates. Keep dataset identifiers, API behavior, hashes, and operational caveats in this catalog rather than the shared skills.
5. Reconcile existing

   README.md

   ,

   AGENTS.md

   ,

   .gitignore

   , and

   pyproject.toml

   instead of overwriting them when adopting. The generated

   AGENTS.md

   contains the exact post-clone skill install commands.
6. Install the project skills using that documented command, open the orientation notebook through

   vignette-catalog-compose-notebook

   , inspect its real output, and run its

   scripts/validate-notebook.sh

   .

src/