Add Delta Codex skill #480

Merged

barrettruth merged 2 commits from ship/delta-codex-skill into main

2026-05-23 02:15:47 +00:00

barrettruth commented

2026-05-23 02:15:30 +00:00

Owner

Problem

Agents using the Delta CLI needed repo-local guidance for safe product operations, and the flake CLI package work was still local-only. The Delta CLI should be available as a small Nix package, while Codex needs a separate skill that describes when and how to use that CLI.

Solution

Expose the Delta CLI through the flake as a Node-target package and app, avoiding the large Bun standalone binary path.
Add a repo-local $delta skill for product/operator CLI usage, with concise command planning, approval boundaries, auth remediation, and scope accuracy rules.
Add agents/openai.yaml metadata for the skill.
Keep the detailed CLI safety matrix in references/cli-safety.md.
Add PyYAML to the devshell so local skill validation runs without manual Python setup.

Verification

nix develop --command python3 /home/barrett/.config/codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/delta
git diff --check --cached && git diff --check
nix flake check --no-build
nix build .#cli --no-link --print-out-paths
nix develop --command just ci

Linked issue

None.

## Problem Agents using the Delta CLI needed repo-local guidance for safe product operations, and the flake CLI package work was still local-only. The Delta CLI should be available as a small Nix package, while Codex needs a separate skill that describes when and how to use that CLI. ## Solution - Expose the Delta CLI through the flake as a Node-target package and app, avoiding the large Bun standalone binary path. - Add a repo-local `$delta` skill for product/operator CLI usage, with concise command planning, approval boundaries, auth remediation, and scope accuracy rules. - Add `agents/openai.yaml` metadata for the skill. - Keep the detailed CLI safety matrix in `references/cli-safety.md`. - Add PyYAML to the devshell so local skill validation runs without manual Python setup. ## Verification - `nix develop --command python3 /home/barrett/.config/codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/delta` - `git diff --check --cached && git diff --check` - `nix flake check --no-build` - `nix build .#cli --no-link --print-out-paths` - `nix develop --command just ci` ## Linked issue None.

barrettruth added 2 commits

2026-05-23 02:15:30 +00:00

build: expose CLI flake package 59da54b971

Add Delta Codex skill

quality / Lint (pull_request) Successful in 31s

Details

quality / Test (pull_request) Successful in 38s

Details

quality / Build (pull_request) Successful in 49s

Details

81e525d0d8

barrettruth merged commit 1b2deb5428 into main

2026-05-23 02:15:47 +00:00

barrettruth referenced this pull request from a commit

2026-05-23 02:15:48 +00:00

Add Delta Codex skill (#480)

No reviewers

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

barrettruth/delta!480

No description provided.

Rows
Columns