goodies git:20260808.9011b0aA

Immutable. This exact content is served forever at /api/v1/blob/3ff43e4d07f397a0.

---
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`).

5. **Sync to Public Repository (`scripts/vault_sync.py`)**
   - Write individual record to `data/items/<slug>.json`.
   - Merge into consolidated `data/vault.json` database.
   - Regenerate client-side search index.
   - 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_sync.py`: Merges vault items, updates aggregate DB, generates Fuse search indices, and handles Git sync.
- `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.