Project

    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.

    AI Ops

    Narrative

    01

    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.

    02

    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.

    03

    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.

    04

    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.

    05

    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

    maintainer, agents, and workflow adopters

    `skills/` contains portable custom Codex skill folders, with suite membership governed by `skills/SUITE_SKILLS.txt` and lifecycle metadata tracked separately.

    Plugin Backup Library

    maintainer and local Codex setup

    `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

    public readers and future contributors

    `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

    operator and reviewing agents

    `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 artifacts

    Workflows

    6 artifacts
    workflowWork date: Date unknown

    Check skill portability beyond the package format

    The September 9 skills discussion found that all 94 inspected folders had a SKILL.md, name and description, then separated that structural result from actual portability. Context Layer was the proposed first candidate because print-production skills depend on a particular workstation, Photoshop, printers and integrations. This workflow records the recommended release gate; it does not claim that clean-machine installation or a portable public release was completed.

    6 steps1 record
    workflowWork date: Date unknown

    Chronicle Visualizer private archive and publication loop

    The operating loop that preserves Chronicle frames and written context privately, verifies encrypted storage, reviews candidate derivatives, and only publishes redacted public timeline assets after human approval.

    8 steps1 record
    workflowWork date: Date unknown

    Codex Skills sync and catalog governance

    How local skill or plugin changes become durable repository artifacts: inspect the repo instructions, compare local skill homes to the allowlisted suite, decide whether new local work belongs in the curated catalog, regenerate source-backed indexes, review docs-site output, and record drift or blockers before publishing or handoff.

    6 steps1 record
    workflowWork date: Date unknown

    Reconcile upstream code and local project documentation without losing evidence

    The September 8 Reconcile main and docs task joined 26 upstream commits with 20 locally changed files in Shopify Headless. Its final source checkpoint reports six documentation conflicts resolved, the V45 pilot renumbered to 1188, indexes refreshed, and a clean synchronized checkpoint at 57f30e43. The reusable Context Layer method is to inventory and preserve work before integration, settle conflicting project ownership, then verify both source evidence and the documents future agents will use.

    6 steps1 record
    workflowWork date: Date unknown

    Review public work with evidence, reversible decisions and readback

    Audit GitHub for YC readiness began with a cross-repository inventory and an interactive review surface. It distinguished signed-in metadata, signed-out public visibility, private implementation and public proof, then tracked the operator’s decisions and verified authorized visibility changes. The reusable method evaluates what a stranger can actually inspect, recommends a small number of useful public examples, and never turns a candidate label into deletion, publication or a settings change.

    6 steps1 record
    workflowWork date: Date unknown

    Take an RPS order from approved cloud master to reconciled print queue

    The September 1–11 print tasks turned orientation mistakes, incorrect source documents and misleading completion totals into explicit production gates. Shopify supplies the catalog orientation; Creative Cloud holds the editable master; Photoshop supplies visual proof; printer records supply reported output. A queued or completed job does not establish good physical output, and one Mac's missing history cannot justify a reprint.

    9 steps1 record

    Images

    11 artifacts

    Chats

    10 artifacts
    chatWork date: Jun 4, 2026

    Building Chronicle MVP

    Codex implementation conversation that turned the Chronicle visual-timeline idea into a working local viewer, corrected the public scaffold into an app-first shape, documented privacy and raw-screenshot boundaries, and added emergency archive scripts plus a durable-private-storage plan for both screen frames and written context.

    1 chat
    chatWork date: Aug 19, 2026

    Chronicle, Computer History, Skysight, and the missing August context

    A public, maximum-transparency investigation of the Chronicle-to-Computer-History shift, the Skysight storage namespace, screenshots and recordings, the corrected August 15-16 discovery failure, and the linked before/after knowledge objects.

    1 chat
    chatWork date: Aug 16, 2026

    Motion and Interaction Design with AI

    A long-running Codex design and implementation task that exposed both the promise and the failure modes of delegating complex GSAP motion to frontier AI models: early code-complete concepts repeatedly missed basic spatial intent, while source-image tracing, real-browser frame capture, and 101-frame contact sheets created a much more reliable visual feedback loop.

    1 chat
    chatWork date: Jul 19, 2026

    Motion Animation Evaluation

    ChatGPT planning conversation that clarified Motion Design Director should center the taste layer for frontend motion, delegate GSAP API details to official GSAP skills, and use a plugin container when the goal is to bundle the custom taste skill with official skills and optional MCP support.

    1 chat
    chatWork date: Jul 15, 2026

    Motion Design Director Plugin Build

    Codex planning and implementation thread that turned a motion-design critique transcript into a local-first `motion-design-director` Codex plugin, bundled official GSAP skills as the implementation layer, pushed the package to the `codex-skills` repository, reconciled the normal local checkout, and drafted prompts for using the plugin to critique Hyphenomenon homepage motion.

    1 chat
    chatWork date: Jul 15, 2026

    Sol Context Layer Compliance Playground

    Codex diagnostic and build thread that investigated why Sol 5.6 was not reliably following repo-installed Context Layer governance, clarified that the issue was likely model-specific instruction-discovery/adherence rather than Context Layer setup, and created a local scenario-based compliance playground for testing future models without reintroducing noisy docs churn on tiny changes.

    1 chat
    chatWork date: Oct 11, 2026 – Oct 11, 2026

    The small portfolio that needed Context Layer

    I questioned the portfolio’s accumulating studies and handoff ZIPs, discovered that I had kept it outside Context Layer, and asked to organize the existing work without losing it.

    1 chat
    chatWork date: Jun 4, 2026

    What Is Chronicle?

    Codex conversation that explained Chronicle as a local screen-history and memory-summary feature, clarified its provenance and actual stored data, and framed the right first product move as a private visual work-history viewer rather than a canonical project-state database.

    1 chat
    chatWork date: Jun 1, 2026

    Working Modes Plugin Migration and Codex Skills Cleanup

    Codex thread that created the dedicated Working Modes plugin, clarified how local plugin sharing differs from public distribution, reframed the codex-skills repository as an installable plugin marketplace plus browsable skill catalog, and committed/pushed the migration batch.

    1 chat
    chatWork date: May 31, 2026

    Working Modes Plugin Package

    Codex session that began with a Critical Thinking Partner mode request and ultimately produced the Working Modes plugin: a local plugin bundle for choosing among critical thinking, rapid iteration, echo-chamber drift correction, and general mode selection.

    1 chat

    Notes

    5 artifacts

    Connected references

    Key dates

    2026-03-21
    Initial skills suite repository

    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.

    2026-04-28
    Docs site and catalog guardrails

    Git history records the addition of the customer docs site and catalog guardrails, followed by Vercel monorepo settings and a calmer public docs design.

    2026-05-12
    Sync workflow repair

    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.

    2026-05-27
    Local Hyphenomenon intake

    This local-only intake created source-backed project artifacts and applied them only to the non-production Hyphenomenon knowledge backbone.