# Goodies

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

- Skill: `broomva/goodies` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add broomva/goodies`
- Raw SKILL.md: https://api.skillmd.com/api/skills/broomva/goodies/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: broomva (https://skillmd.com/u/broomva)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/broomva/goodies

---


# 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 & Publish (`scripts/vault_sync.py`)**
   - Write individual record to `data/items/<slug>.json`.
   - Merge into consolidated `data/vault.json` database.
   - Regenerate client-side search index (`data/search-index.json`).
   - Scaffold missing OSS standards (`LICENSE`, `CONTRIBUTING.md`, `.gitignore`, enhanced `README.md` with badges & live links).
   - Enforce CSS `[hidden] { display: none !important; }` rule to guarantee modal backdrops stay hidden on load.
   - Sync GitHub repository metadata (`description`, `homepage`, `topics`) via `gh repo edit`.
   - 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, scaffolds OSS files, syncs GH repo metadata, 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.