Skip to content

Add experimental ExecFence skill#385

Open
chrystyan96 wants to merge 5 commits into
openai:mainfrom
chrystyan96:add-execfence-skill
Open

Add experimental ExecFence skill#385
chrystyan96 wants to merge 5 commits into
openai:mainfrom
chrystyan96:add-execfence-skill

Conversation

@chrystyan96
Copy link
Copy Markdown

@chrystyan96 chrystyan96 commented May 1, 2026

Summary

  • add an experimental ExecFence skill for OpenAI Skills
  • document when agents should run execfence scan, execfence ci, and execfence run -- <command>
  • add guard-mode guidance so agents prefer npx --yes execfence guard enable and project-local rules for automatic build/dev/test protection when the installed CLI supports it
  • clarify that the npm CLI remains the executable guardrail and the skill supplies agent behavior/instructions

ExecFence Automatic Guard Mode Summary

The related ExecFence project PR introduces a dry-run-first automatic guard mode for persistent projects. The skill now treats this as the preferred path for ExecFence v3.1.0+ and keeps init/scan/run/coverage/wire as the fallback when guard is unavailable.

  • npx --yes execfence guard enable shows a project-local protection plan without writing files
  • npx --yes execfence guard enable --apply applies reversible wrappers, CI wiring, and project-local agent rules
  • npx --yes execfence guard status reports protected and unprotected entrypoints
  • npx --yes execfence guard disable removes only changes ExecFence can identify as generated by ExecFence
  • npx --yes execfence guard global-enable installs global skill/defaults and agent rules only; it does not alter PATH, aliases, shims, shell profiles, or globally intercept package managers/shell commands

This means the skill should guide agents toward guard mode for broad adoption, while the npm CLI remains the component that actually scans, blocks, writes reports, and returns exit codes.

Review / Validation

ExecFence gives Codex a repeatable workflow for adding local execution guardrails before dev, build, test, CI, package, and agent tool execution in persistent projects.

Tested: python skills/.system/skill-creator/scripts/quick_validate.py skills/.experimental/execfence
@chrystyan96 chrystyan96 requested a review from a team May 1, 2026 19:08
The ExecFence CLI is now published on npm and has a GitHub Pages documentation site, so the experimental skill should point agents at those canonical entry points. The OpenAI interface metadata also now follows the default-prompt convention by explicitly mentioning $execfence.

Tested: python skills/.system/skill-creator/scripts/quick_validate.py skills/.experimental/execfence
ExecFence 3.1 adds automatic project guard mode, so the experimental OpenAI skill should prefer guard enable for broad project setup while keeping direct init/run commands available for narrower adoption.

Tested: python skills/.system/skill-creator/scripts/quick_validate.py skills/.experimental/execfence
The OpenAI skill should state the new recommended adoption path directly so agents prefer guard mode instead of only individual commands.

Scope-risk: narrow

Tested: git diff --check
The skill should not assume guard mode exists in every published ExecFence CLI version, so it now treats guard as the preferred path for v3.1.0+ and keeps the existing init/scan/run fallback.

Constraint: npm latest may lag the project PR that introduces guard mode

Scope-risk: narrow

Tested: git diff --check

Tested: frontmatter and required skill files parsed with a local format check
@chrystyan96
Copy link
Copy Markdown
Author

@codex review

@chatgpt-codex-connector
Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Bravo.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant