Skip to content

Add Codex wrappers for Claude skills#1551

Open
meenchen wants to merge 1 commit into
mainfrom
add-codex-claude-skill-wrappers
Open

Add Codex wrappers for Claude skills#1551
meenchen wants to merge 1 commit into
mainfrom
add-codex-claude-skill-wrappers

Conversation

@meenchen
Copy link
Copy Markdown
Contributor

@meenchen meenchen commented May 28, 2026

What does this PR do?

Type of change: enable skills for codex

Claude reads the skill at:

.claude/skills/ptq/SKILL.md

Codex sees it through:

.codex/skills/ptq/SKILL.md -> .claude/skills/ptq/SKILL.md

The old skill text referenced shared files as skills/common/.... That path only makes
sense to Claude if it treats .claude as a special root. From Codex’s symlinked view,
skills/common/... would not resolve cleanly.

So I changed references like:

skills/common/environment-setup.md

to:

../common/environment-setup.md

That is path-relative from the skill directory, so it works in both views:

  • from .claude/skills/ptq/: ../common/...
  • from .codex/skills/ptq/ symlink view: same target

I did not change the workflow content, just made internal references portable.

Usage

# Add a code snippet demonstrating how to use this

Testing

Run codex and verify skills are correctly loaded

Before your PR is "Ready for review"

Make sure you read and follow Contributor guidelines and your commits are signed (git commit -s -S).

Make sure you read and follow the Security Best Practices (e.g. avoiding hardcoded trust_remote_code=True, torch.load(..., weights_only=False), pickle, etc.).

  • Is this change backward compatible?: ✅ / ❌ / N/A
  • If you copied code from any other sources or added a new PIP dependency, did you follow guidance in CONTRIBUTING.md: ✅ / ❌ / N/A
  • Did you write any new necessary tests?: ✅ / ❌ / N/A
  • Did you update Changelog?: ✅ / ❌ / N/A
  • Did you get Claude approval on this PR?: ✅ / ❌ / N/A

Additional Information

Summary by CodeRabbit

  • Documentation

    • Updated cross-references in deployment, evaluation, and quantization skill documentation for consistency.
  • Chores

    • Reorganized skills directory structure with symbolic link updates.

Review Change Stack

@meenchen meenchen self-assigned this May 28, 2026
@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 28, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@meenchen meenchen requested review from chadvoegele, cjluo-nv, kaix-nv and mxinO and removed request for chadvoegele and kaix-nv May 28, 2026 00:06
Signed-off-by: weimingc <17592131+meenchen@users.noreply.github.com>
@meenchen meenchen force-pushed the add-codex-claude-skill-wrappers branch from 72cbf54 to 9aa040c Compare May 28, 2026 00:10
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 28, 2026

📝 Walkthrough

Walkthrough

This PR refactors skill documentation to use relative parent paths (../common/...) instead of absolute skill paths. The deployment skill adds container registry authentication validation before SLURM job submission. A symlink is created for backwards compatibility with the original .codex reference path.

Changes

Documentation Path Refactoring and Deployment Validation

Layer / File(s) Summary
Deployment skill path updates and registry auth preflight
.claude/skills/deployment/SKILL.md
Updates workspace management and environment setup references to use relative paths. Adds a new preflight validation step requiring confirmation of container registry authentication before submitting SLURM jobs using container images. Updates SLURM setup reference path.
Evaluation skill documentation path updates
.claude/skills/evaluation/SKILL.md
Updates workspace management and SLURM setup references from absolute skills/common/... to relative ../common/... paths.
PTQ skill documentation path updates and references
.claude/skills/ptq/SKILL.md
Updates environment setup, remote execution, and SLURM setup references to relative paths. Updates "Common Pitfalls" and references table entries for consistency with new relative path structure.
Backwards-compatibility symlink
.codex/skills
Creates a symlink pointing to ../.claude/skills to maintain backwards compatibility.

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 6
✅ Passed checks (6 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title 'Add Codex wrappers for Claude skills' accurately reflects the main change: creating symlinked Codex wrappers to access Claude skills and fixing relative reference paths for portability.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Security Anti-Patterns ✅ Passed PR makes no Python code changes—only documentation updates (.md files) and a symlink addition. Security anti-patterns check is inapplicable.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-codex-claude-skill-wrappers

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Warning

CodeRabbit couldn't request changes on this pull request because it doesn't have sufficient GitHub permissions.

Please grant CodeRabbit Pull requests: Read and write permission and re-run the review.

👉 Steps to fix this

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.claude/skills/deployment/SKILL.md:
- Line 177: The "Check container registry auth" preflight line currently
requires credential verification for any SLURM container-image job; update the
text in SKILL.md so it only mandates auth checks for private or
access-restricted registries (or else add wording that public images do not
require auth), e.g., change the instruction to scope verification to images
hosted on private registries and reference ../common/slurm-setup.md section 6
for how to confirm auth, or explicitly document the rationale if you intend
stricter enforcement; ensure the step's title/phrase "Check container registry
auth" and its sentence about not submitting until auth is confirmed are adjusted
accordingly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 0c51caf2-68f7-4887-9a9b-e86c66737080

📥 Commits

Reviewing files that changed from the base of the PR and between b49f9b9 and 9aa040c.

📒 Files selected for processing (4)
  • .claude/skills/deployment/SKILL.md
  • .claude/skills/evaluation/SKILL.md
  • .claude/skills/ptq/SKILL.md
  • .codex/skills

If a cluster config exists (`~/.config/modelopt/clusters.yaml` or `.claude/clusters.yaml`), or the user mentions running on a remote machine:

0. **Check container registry auth** — before submitting any SLURM job with a container image, verify credentials exist on the cluster per `skills/common/slurm-setup.md` section 6. If credentials are missing for the image's registry, ask the user to fix auth or switch to an image on an authenticated registry (e.g., NGC). **Do not submit until auth is confirmed.**
0. **Check container registry auth** — before submitting any SLURM job with a container image, verify credentials exist on the cluster per `../common/slurm-setup.md` section 6. If credentials are missing for the image's registry, ask the user to fix auth or switch to an image on an authenticated registry (e.g., NGC). **Do not submit until auth is confirmed.**
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.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Align container-auth preflight policy with private/public image logic.

This step currently requires credential verification for any SLURM container-image job, which conflicts with the evaluation skill’s private-only check and can block valid public-image submissions. Please scope the preflight to private/access-restricted registries (or explicitly document why deployment must be stricter).

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.claude/skills/deployment/SKILL.md at line 177, The "Check container
registry auth" preflight line currently requires credential verification for any
SLURM container-image job; update the text in SKILL.md so it only mandates auth
checks for private or access-restricted registries (or else add wording that
public images do not require auth), e.g., change the instruction to scope
verification to images hosted on private registries and reference
../common/slurm-setup.md section 6 for how to confirm auth, or explicitly
document the rationale if you intend stricter enforcement; ensure the step's
title/phrase "Check container registry auth" and its sentence about not
submitting until auth is confirmed are adjusted accordingly.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 28, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.70%. Comparing base (b49f9b9) to head (9aa040c).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1551   +/-   ##
=======================================
  Coverage   76.70%   76.70%           
=======================================
  Files         477      477           
  Lines       51977    51977           
=======================================
+ Hits        39868    39869    +1     
+ Misses      12109    12108    -1     
Flag Coverage Δ
unit 52.76% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@mxinO
Copy link
Copy Markdown
Contributor

mxinO commented May 28, 2026

I remember we have a PR for general agent support, renaming .calude -> .agent, and all agent harness use a symlink to .agent @kaix-nv

@chadvoegele
Copy link
Copy Markdown
Contributor

Related PR: #1362

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.

3 participants