git:20260808.9011b0a to git:20260808.6a8288a

---

name: goodies

category: knowledge

description: >

Ingest, contextualize, and index curated resources (websites, tools, design references,

research papers, UI kits) into a public GitHub Pages vault while automatically linking

them to the local Knowledge Graph via /checkit and P6 bookkeeping. Dynamically resolves

and expands category ontologies, generates client-side search indices, and publishes

the updated vault database to a public repository. USE WHEN: /goodies, goodies,

goodies add, add to goodies, bookmark this site, save to goodies, bookmark good resource,

curate website. NOT FOR: internal-only notes without public vault indexing; general web

searches without curating a resource.

---

# goodies — Curate, KG-Index, and Publish to Public Goodies Vault

`/goodies` takes a URL or resource pointer (website, tool, design reference, research paper), metabolizes it into the local Knowledge Graph using `/checkit` and P6 bookkeeping, dynamically classifies it within an evolving category taxonomy, and publishes the rich record to a public GitHub Pages repository (`goodies`).

It is a **bstack composition skill**: it fires `/checkit` research, P6 bookkeeping, dynamic taxonomy resolution, and git sync scripts in sequence.

## The One Rule

> **Curate with depth, index with provenance, publish with dynamic taxonomy.**

>

> A resource saved to goodies must never be a bare link. It must carry deep context, primary-source verification, Knowledge Graph linkage (`kgEntity`), and an evolving category taxonomy so the public vault remains searchable, beautiful, and valuable.

## Pipeline (what `/goodies add <URL>` does)

1. **Ingest & Verify (`/checkit`)**

- Run the `/checkit` pipeline on the target URL/artifact.

- Fetch primary source verbatim, extract title, tagline, deep summary, key highlights, stack tags, and favicon/OG image.

2. **Index into Knowledge Graph (P6 Bookkeeping)**

- Create or update the corresponding entity page in `research/entities/tool/` or `research/entities/concept/`.

- Score the entity using Nous gate criteria (novelty, specificity, relevance).

- Capture `kgEntity` reference path for vault linking.

3. **Dynamic Taxonomy Resolution**

- Execute `scripts/vault_schema.py` to inspect `data/taxonomy.json`.

- Determine if the resource fits an existing category OR dynamically expands the ontology with a new category node.

- Assign primary category, subcategory, and tag taxonomy.

4. **Format & Validate Vault Record**

- Construct Vault Item JSON conforming to schema specification.

- Execute schema validation tests (`scripts/vault_schema.py`).

- Write individual record to `data/items/<slug>.json`.

- Merge into consolidated `data/vault.json` database.

- Commit & push to public repository (e.g. `goodies`), triggering GitHub Pages auto-deploy.

## Deterministic Scripts & Core Tools

- `scripts/vault_schema.py`: Validates item JSON schemas and manages dynamic category taxonomy resolution.

- `scripts/vault_ingest.py`: Orchestrates URL ingestion, `/checkit` extraction, metadata scraping, and item construction.

## Anti-Rationalization

| Excuse | Reality |

|---|---|

| "A bare link and title is enough." | Bare links degrade quality. /goodies requires summary, highlights, and KG provenance. |

| "Categories should be hardcoded." | Categories are dynamic ontologies that evolve as new domains are discovered. |

| "I'll sync the public repo later." | The skill commits & pushes automatically to keep GitHub Pages live and fresh. |

## Validation

- Executing `python3 scripts/vault_schema.py` validates schema compliance.

- Executing `pytest tests/` runs unit tests for schema and sync modules.

- Executing `bstack skills audit` verifies skill integrity.

## References

- [`references/vault-architecture.md`](references/vault-architecture.md) — Architectural specification for vault data model and GitHub Pages integration.