Codex Skills Library
Codex Skills Library is the durable source repository for Maggie Lerman's custom Codex skills, custom local plugin backups, generated skill catalogs, and the public docs site that explains the workflows. The repo turns local agent behavior into portable, inspectable artifacts: each skill folder carries trigger metadata, instructions, references, scripts, examples, assets, and validation expectations, while the catalog tooling keeps the public docs aligned with the suite allowlist.
Narrative
Portable Workflows As Source Code
Codex Skills Library turns repeatable agent behavior into source-controlled folders rather than loose prompts or chat memory. The project keeps each skill portable with trigger metadata, instructions, references, scripts, examples, assets, and agent metadata, then uses generated catalogs to make the suite inspectable. The important decision is operational: workflows should be reusable and reviewable, but still checked inside the target repository where local instructions, constraints, and verification commands matter.
Catalog Discipline And Human Review
The repository separates skill membership, lifecycle metadata, generated catalog output, plugin backups, and public docs-site pages. Catalog scripts detect drift before regeneration, while the maintainer decides whether a local skill belongs in the curated suite or should stay outside the public catalog. That distinction matters because the repo is public-learning-oriented but still preserves provenance-sensitive skill folders, third-party notices, local plugin backups, and unresolved license boundaries.
Current Intake Boundary
This intake records the repo locally as a Hyphenomenon project without mutating the production knowledge database. The captured state includes a local docs-site review, source-backed hydration artifacts, and an explicit drift finding: an in-progress hyphenomenon-chat-intake skill folder exists outside skills/SUITE_SKILLS.txt. That is useful proof of the real operating model because the project depends on human/operator review before deciding whether local skill work becomes curated public catalog content.
Portability and evidence-preserving Context Layer workflows — September 2026
The September 9 public-presence review found SKILL.md, name and description in all 94 inspected skill folders, then separated structural validity from portable execution. The recommended next proof was a clean installation and representative task with declared dependencies and personal assumptions removed. Context Layer was the proposed first release candidate; RPS production remained dependent on the operator’s Photoshop, printers and integrations. A portable release was recommended, not verified.
A September 8 Shopify Headless reconciliation provides a concrete Context Layer example: preserve local evidence, integrate upstream, resolve six docs conflicts, renumber the V45 pilot to 1188, refresh lifecycle references and validate the resulting checkpoint. Its source reports 26 upstream commits and 20 local files reconciled at 57f30e43. The generalizable result is a preservation and handoff method, not permission to discard dirty files or reproduce the old branch state.
The public-presence audit also produced a searchable decision review with signed-out evidence and saved-state readback. It kept recommendations separate from operator-authorized visibility changes and did not confuse private builder-profile settings with a public URL.
September 2026: print-production gates learned from operational failure
Queue latest Faire order exposed execution failures despite an existing duplicate-and-resize procedure: incomplete cloud discovery was treated as absence, source images/local files were used instead of the approved cloud master, a clipping warning was bypassed, and queue success was overstated. The September 2 source reports a focused rps-print-order skill patch: Shopify-derived orientation including Faire orders; exact current Creative Cloud folder checks; canvas-first duplication for missing sizes; positive absence proof for new art; saved .psdc identity; visual preview stop conditions; and paused queues unless resumption is authorized. Current skill-source inspection confirms the shared submission procedure's orientation, warning and filename checks. Print new order adds a September 11 accounting lesson: canceled jobs may report printed sheets, reprints must be separated, and missing history on one Mac cannot establish unprinted work across hosts. The reusable improvement is explicit evidence and operator review at each state boundary, with physical output verified separately.
System surfaces
Skill Source Library
`skills/` contains portable custom Codex skill folders, with suite membership governed by `skills/SUITE_SKILLS.txt` and lifecycle metadata tracked separately.
Plugin Backup Library
`plugins/` preserves selected custom local plugin bundles separately from the standalone skill suite so larger surfaces keep plugin metadata, assets, scripts, and bundled skills intact.
Generated Public Docs Site
`docs-site/` is a Next.js catalog and documentation surface generated from source metadata so readers can browse skills and plugin patterns without hand-maintained marketing pages.
Repo-Native Evidence And Project Memory
`DOCS/` stores lean notes, project memory, evidence, and intake artifacts for repository maintenance without turning the repo into a full delivery scaffold.
Implementation stack
Skill And Plugin Artifacts
- • Codex SKILL.md folders
- • agent metadata YAML
- • reference files
- • bundled scripts
- • plugin.json metadata
- • repo-local plugin registry
Catalog Tooling
- • Python catalog builder
- • suite allowlist
- • suite lifecycle metadata
- • generated Markdown index
- • generated JSON manifest
- • generated TypeScript docs-site catalog
Docs Site Runtime
- • Next.js 16
- • React 19
- • TypeScript
- • Tailwind CSS
- • shadcn/base-ui
- • lucide-react
Verification
- • python3 scripts/build_catalog.py --check
- • python3 scripts/build_catalog.py
- • python3 scripts/build_docs_site_catalog.py
- • docs-site npm run build
- • local browser screenshots
Evidence
34 artifacts grouped by type so each kind of proof can be scanned on its own.
Data models
2 artifactsWorkflows
6 artifactsCheck skill portability beyond the package format
Chronicle Visualizer private archive and publication loop
Codex Skills sync and catalog governance
Reconcile upstream code and local project documentation without losing evidence
Review public work with evidence, reversible decisions and readback
Take an RPS order from approved cloud master to reconciled print queue
Images
11 artifacts
imageChronicle Visualizer Detail View
imageChronicle Visualizer Timeline Overview - Bottom
imageChronicle Visualizer Timeline Overview - Lower Middle
imageChronicle Visualizer Timeline Overview - Top
imageChronicle Visualizer Timeline Overview - Upper Middle
imageGenerated plugin backup detail route showing larger bundled workflow metadata.
imageGenerated skill detail route for the Hyphenomenon project-intake workflow.
imageLibrary docs and generated skill catalog browsing flow.
imagePeriod Line V2 Live-Browser 101-Frame Contact Sheet
imagePublic-facing home route for the Codex skills library and workflow notes.
imageWorking Modes Plugin Screenshot
Chats
10 artifactsBuilding Chronicle MVP
Chronicle, Computer History, Skysight, and the missing August context
Motion and Interaction Design with AI
Motion Animation Evaluation
Motion Design Director Plugin Build
Sol Context Layer Compliance Playground
The small portfolio that needed Context Layer
What Is Chronicle?
Working Modes Plugin Migration and Codex Skills Cleanup
Working Modes Plugin Package
Notes
5 artifactsConnected references
Key dates
Git history shows the repository began with `Initial codex skills suite repository`, then quickly narrowed to an allowlisted custom skill suite with explicit lifecycle metadata.
Git history records the addition of the customer docs site and catalog guardrails, followed by Vercel monorepo settings and a calmer public docs design.
Git history records a skills sync workflow repair, aligning with the durable convention that local Codex skills are reconciled into this repository through explicit checks.
This local-only intake created source-backed project artifacts and applied them only to the non-production Hyphenomenon knowledge backbone.