Skip to content

chore(skills): remove openai sidecars#60

Merged
MSicc merged 1 commit into
developmentfrom
codex/codex-plugin-packaging
Jul 7, 2026
Merged

chore(skills): remove openai sidecars#60
MSicc merged 1 commit into
developmentfrom
codex/codex-plugin-packaging

Conversation

@MSicc

@MSicc MSicc commented Jul 7, 2026

Copy link
Copy Markdown
Member

Summary

  • remove skills/*/agents/openai.yaml sidecars from the shipped skills
  • keep the canonical SKILL.md files and Codex plugin packaging unchanged

Why

These sidecars were only carrying lightweight Codex UI metadata and an explicit allow_implicit_invocation: true setting, which matches the documented default behavior. They were not required for plugin installation or core skill discovery, so removing them reduces maintenance overhead without changing the main workflow.

User impact

  • skill loading and plugin installation continue to work through the existing SKILL.md files and plugin packaging
  • Codex falls back to the normal skill metadata path instead of the optional sidecar files
  • repository maintenance is simpler because there is one less per-skill metadata file to keep in sync

Validation

  • verified that no skills/*/agents/openai.yaml files remain in the worktree
  • no code or runtime behavior changed beyond removing optional metadata files

@MSicc
MSicc marked this pull request as ready for review July 7, 2026 06:28
Copilot AI review requested due to automatic review settings July 7, 2026 06:28
@MSicc
MSicc merged commit e8cf2c4 into development Jul 7, 2026
@MSicc
MSicc deleted the codex/codex-plugin-packaging branch July 7, 2026 06:31

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR removes the per-skill skills/*/agents/openai.yaml sidecar files that previously provided OpenAI Codex UI metadata and invocation policy hints, intending to rely on the canonical SKILL.md artifacts and existing plugin packaging instead.

Changes:

  • Deleted agents/openai.yaml sidecars from shipped skills to reduce per-skill metadata maintenance.
  • Left canonical SKILL.md skill definitions and plugin packaging structure unchanged.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.

Show a summary per file
File Description
skills/validate-usercontext-instructions/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/validate-skill/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/validate-project-instructions/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/validate-agents-md/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/restore-checkpoint/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/repository-drift-control/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/create-usercontext-instructions/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/create-skill/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/create-project-instructions/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/create-checkpoint/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
skills/create-agents-md/agents/openai.yaml Remove OpenAI Codex sidecar metadata file for this skill
Comments suppressed due to low confidence (2)

skills/repository-drift-control/agents/openai.yaml:1

  • PR description says the OpenAI sidecars only carried an allow_implicit_invocation: true setting that matches the default, but this sidecar explicitly sets allow_implicit_invocation: false. If Codex falls back to a default of true when the sidecar is absent, removing this file changes invocation behavior for this governance skill. Please either (a) confirm Codex’s fallback default keeps this non-implicit behavior, (b) encode the explicit-invocation policy in the canonical metadata path used without sidecars, or (c) keep sidecars for the small set of skills that require allow_implicit_invocation: false. Also consider correcting the PR description to reflect that not all sidecars had allow_implicit_invocation: true.
    skills/validate-agents-md/agents/openai.yaml:1
  • After removing these agents/openai.yaml files, repository docs currently become stale: README.md explicitly states each skill includes an agents/openai.yaml sidecar (README.md:396-401) and CHANGELOG.md entries reference agents/openai.yaml sidecars (e.g., CHANGELOG.md:21-22,48-49,56). Please update those docs to reflect the new Codex metadata fallback behavior so users don’t look for files that no longer exist.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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.

2 participants