Skip to content

Refactoring agentic skill files based on roles and modules #818

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rapids-bot merged 14 commits into from
Feb 5, 2026
Merged

Refactoring agentic skill files based on roles and modules #818

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
bc40a04
Adding new skill based structure
rgsl888prabhu Jan 30, 2026
7250813
update
rgsl888prabhu Jan 30, 2026
53e5541
update codeowners file for agents and few other template files
rgsl888prabhu Jan 30, 2026
eb8e45c
style
rgsl888prabhu Jan 30, 2026
793f153
fix
rgsl888prabhu Jan 31, 2026
1aefd60
Merge branch 'main' into add_agentic_skill
rgsl888prabhu Jan 31, 2026
02519b1
Add more details
rgsl888prabhu Feb 2, 2026
06c4af4
Add more reference
rgsl888prabhu Feb 2, 2026
ddacaec
Merge branch 'add_agentic_skill' of github.com:rgsl888prabhu/cuopt_pu…
rgsl888prabhu Feb 2, 2026
aa9dd73
fix C API
rgsl888prabhu Feb 2, 2026
309db04
udpate rules
rgsl888prabhu Feb 2, 2026
7281759
remove legacy
rgsl888prabhu Feb 2, 2026
7b98a7a
review
rgsl888prabhu Feb 2, 2026
27a0865
remove cuopt.yaml files
rgsl888prabhu Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 0 additions & 9 deletions .ai/skills/cuopt.yaml
View file
Open in desktop

This file was deleted.

85 changes: 0 additions & 85 deletions .github/.ai/skills/cuopt.yaml
View file
Open in desktop

This file was deleted.

35 changes: 26 additions & 9 deletions .github/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,32 @@
# AGENTS.md - AI Coding Agent Guidelines for cuOpt
# AGENTS.md - cuOpt AI Agent Entry Point

This file is intentionally **minimal**. Choose a role and follow the matching rules:
AI agent skills for NVIDIA cuOpt optimization engine.

- **Using cuOpt (model + solve problems)**: `.github/agents/cuopt-user.md`
- **Developing cuOpt (changing this repo)**: `.github/agents/cuopt-developer.md`
## Quick Start

### Machine-readable skill manifest
| Task | Read These Skills |
|------|-------------------|
| **Using cuOpt** (routing, LP, etc.) | `skills/cuopt-user-rules/` → then domain skill |
| **Developing cuOpt** (contributing) | `skills/cuopt-developer/` |

- **Primary**: `.github/.ai/skills/cuopt.yaml`
- **Root shim (compat)**: `.ai/skills/cuopt.yaml`
## Skills Directory

### Canonical contribution guide
See `skills/README.md` for the full index.

- `CONTRIBUTING.md`
### User Skills (read cuopt-user-rules first)
- `skills/cuopt-routing/` — VRP, TSP, PDP
- `skills/cuopt-lp-milp/` — Linear programming, integer variables
- `skills/cuopt-qp/` — Quadratic programming
- `skills/cuopt-debugging/` — Troubleshooting
- `skills/cuopt-installation/` — Setup & requirements
- `skills/cuopt-server/` — REST API deployment

### Developer Skill (has its own rules)
- `skills/cuopt-developer/` — Contributing code
Comment on lines +7 to +25
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Feb 3, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

# Check if .github/AGENTS.md exists and read its content
if [ -f ".github/AGENTS.md" ]; then
  echo "=== .github/AGENTS.md exists ==="
  cat -n ".github/AGENTS.md" | head -30
else
  echo ".github/AGENTS.md not found"
fi

Repository: NVIDIA/cuopt

Length of output: 1282

🏁 Script executed:

# Check for skills directories in the repository
echo "=== Checking for skills directories ==="
find . -type d -name "skills" 2>/dev/null | head -20

Repository: NVIDIA/cuopt

Length of output: 112

🏁 Script executed:

# List contents of .github/ to understand structure
echo "=== Contents of .github/ ==="
if [ -d ".github" ]; then
  ls -la ".github/" | head -30
fi

Repository: NVIDIA/cuopt

Length of output: 928

🏁 Script executed:

# Check if there are skills directories at repo root or under .github/
echo "=== Checking repo structure ==="
git ls-files | grep -E "^\.?/?skills/" | head -20

Repository: NVIDIA/cuopt

Length of output: 87

🏁 Script executed:

# List the contents of .github/skills/
echo "=== Contents of .github/skills/ ==="
if [ -d ".github/skills" ]; then
  ls -la ".github/skills/" | head -20
else
  echo ".github/skills/ not found"
fi

Repository: NVIDIA/cuopt

Length of output: 782

🏁 Script executed:

# Check if skills exist at repo root level
echo "=== Checking for skills at repo root ==="
if [ -d "./skills" ]; then
  ls -la "./skills/" | head -20
else
  echo "./skills/ not found at repo root"
fi

Repository: NVIDIA/cuopt

Length of output: 129

🏁 Script executed:

# Get a better listing of what's actually tracked or present
echo "=== All directories under .github/ ==="
find .github -maxdepth 2 -type d | sort

Repository: NVIDIA/cuopt

Length of output: 396

Clarify skill paths as .github/skills/... to avoid ambiguity.

The paths in this document are currently referenced as skills/..., but all these directories actually exist under .github/skills/. While these relative references technically resolve correctly from the document's location, they can be ambiguous when viewed from the repo root or on GitHub. Use explicit .github/skills/... paths throughout to make the references unambiguous.

Affected locations

Quick Start table (lines 9–10), Skills Directory heading (line 14), and all skill paths in the list (lines 17–22, 25).

🤖 Prompt for AI Agents 
In @.github/AGENTS.md around lines 7 - 25, Update all relative skill paths in
the AGENTS.md content to be explicit by prefixing them with .github/skills/
(e.g., change occurrences of skills/cuopt-user-rules/, skills/cuopt-developer/,
skills/cuopt-routing/, skills/cuopt-lp-milp/, skills/cuopt-qp/,
skills/cuopt-debugging/, skills/cuopt-installation/, skills/cuopt-server/ and
the reference skills/README.md to .github/skills/cuopt-user-rules/,
.github/skills/cuopt-developer/, .github/skills/cuopt-routing/,
.github/skills/cuopt-lp-milp/, .github/skills/cuopt-qp/,
.github/skills/cuopt-debugging/, .github/skills/cuopt-installation/,
.github/skills/cuopt-server/ and .github/skills/README.md respectively so every
path is unambiguous when viewed from the repo root or GitHub UI.


## Resources

- [cuOpt Documentation](https://docs.nvidia.com/cuopt/user-guide/latest/)
- [cuopt-examples repo](https://github.com/NVIDIA/cuopt-examples)
- [GitHub Issues](https://github.com/NVIDIA/cuopt/issues)
- [Developer Forums](https://forums.developer.nvidia.com/c/ai-data-science/nvidia-cuopt/514)
15 changes: 12 additions & 3 deletions .github/CODEOWNERS
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,18 @@ docs/ @nvidia/cuopt-infra-codeowners
container-builder/ @nvidia/cuopt-infra-codeowners

#CI code owners
/.github/ @nvidia/cuopt-ci-codeowners
/ci/ @nvidia/cuopt-ci-codeowners
/.pre-commit-config.yaml @nvidia/cuopt-ci-codeowners
/.github/ @nvidia/cuopt-ci-codeowners
/ci/ @nvidia/cuopt-ci-codeowners
/.pre-commit-config.yaml @nvidia/cuopt-ci-codeowners

#agent/infra code owners (overrides .github/ for specific paths)
/AGENTS.md @nvidia/cuopt-infra-codeowners
/.ai/ @nvidia/cuopt-infra-codeowners
/.github/.coderabbit_review_guide.md @nvidia/cuopt-infra-codeowners
/.github/ISSUE_TEMPLATE/ @nvidia/cuopt-infra-codeowners
/.github/PULL_REQUEST_TEMPLATE.md @nvidia/cuopt-infra-codeowners
/.github/skills/ @nvidia/cuopt-infra-codeowners
/.github/agents-legacy/ @nvidia/cuopt-infra-codeowners
Comment thread
rgsl888prabhu marked this conversation as resolved.

#packaging code owners
/.devcontainer/ @nvidia/cuopt-ci-codeowners
Expand Down
184 changes: 0 additions & 184 deletions .github/agents/cuopt-developer.md
View file
Open in desktop

This file was deleted.

Loading