Zoen Skills

A curated, Codex-compatible engineering skillset for taking Zoen from product discovery to safe production delivery.

This repository contains:

• 23 adapted skills from mattpocock/skills;
• zoen-product-engineering, the integrating skill for Zoen's ontology-first architecture and delivery doctrine;
• builder-ethos, the Zoen XP rewrite of the three AI-era build gates (boil the lake, search before building, user sovereignty);
• ontology-design, Palantir Foundry ontology best practices, structural guidance, and anti-patterns for designing and reviewing object models;
• the complete Extreme Programming system used by that skill: 5 values, 14 principles, 13 primary practices, 11 corollary practices, and the useful first-edition vocabulary.

Install

Review the available skills:

npx skills add EnzoTironi/skills --list

Install the full set for every supported agent:

npx skills add EnzoTironi/skills --all

Install only the Zoen core globally:

npx skills add EnzoTironi/skills \
  --skill zoen-product-engineering builder-ethos setup-matt-pocock-skills tdd code-review \
  --global --yes

Or run the interactive installer:

npx skills add https://github.com/EnzoTironi/skills

Start here

Use $zoen-product-engineering as the router for Zoen work. It selects the smallest useful flow and keeps these constraints explicit:

• nouns, links, verbs, policies, and evidence as the owned product kernel;
• AgentRun and ToolCall provenance;
• effectful operations through an approval-aware Action Gateway;
• tenant isolation, least privilege, auditability, client-owned export, and reversible production changes;
• small vertical slices delivered through red → green → refactor.

For a new Zoen codebase:

1. Run $setup-matt-pocock-skills.
2. Use $wayfinder if the effort is larger than one agent session, or $grill-with-docs for a bounded product decision.
3. Route the resulting work through $zoen-product-engineering.

Catalog

Area	Skills
Discovery and decisions	grill-with-docs, grilling, wayfinder, prototype, research
Domain and architecture	domain-modeling, ontology-design, codebase-design, design-an-interface, improve-codebase-architecture, setup-ts-deep-modules
Specification and delivery	to-spec, to-tickets, implement, tdd, setup-pre-commit
Quality and operations	diagnosing-bugs, code-review, resolving-merge-conflicts, triage, qa, handoff
Skill system	setup-matt-pocock-skills, writing-great-skills, zoen-product-engineering, builder-ethos

Repository layout

Skills live at .agents/skills/<skill-name>/. Each directory contains a SKILL.md, its Codex interface metadata (agents/openai.yaml), and any references, scripts, or templates it needs. Cursor-style disable-model-invocation in skill frontmatter is allowed for user-invoked skills.

Run the repository validator after editing:

python3 scripts/validate_skills.py

Provenance

The Matt Pocock skills were adapted for ChatGPT/Codex compatibility, including $skill references, Codex interface metadata, GitHub app-first workflows, a native Markdown/Mermaid architecture report, and a complete red → green → refactor TDD loop.

See NOTICE.md and LICENSE for attribution and licensing.