Repository navigation
skills/cuopt-numerical-optimization-api-cli: update with benchmark details #1331
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.
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
ramakrishnap-nv
merged 2 commits into
main
from
skills-cuopt-numerical-optimization-api-cli
May 29, 2026
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,88 @@ | ||
| # Evaluation Report | ||
|
|
||
| Evaluation of the `cuopt-numerical-optimization-api-cli` skill before publication through NVSkills-Eval. | ||
|
|
||
| This benchmark summarizes 3-Tier Evaluation from NVSkills-Eval results for the skill. The goal is to document whether the skill is safe, discoverable, effective, and useful for agents before it is published for broader workflow use. | ||
|
|
||
| ## Evaluation Summary | ||
|
|
||
| - Skill: `cuopt-numerical-optimization-api-cli` | ||
| - Evaluation date: 2026-05-29 | ||
| - NVSkills-Eval profile: `external` | ||
| - Environment: `local` | ||
| - Dataset: 1 evaluation tasks | ||
| - Attempts per task: 2 | ||
| - Pass threshold: 50% | ||
| - Overall verdict: PASS | ||
|
|
||
| ## Agents Used | ||
|
|
||
| - `claude-code` | ||
| - `codex` | ||
|
|
||
| ## Metrics Used | ||
|
|
||
| Reported benchmark dimensions: | ||
|
|
||
| - Security: checks whether skill-assisted execution avoids unsafe behavior such as secret leakage, destructive commands, or unauthorized access. | ||
| - Correctness: checks whether the agent follows the expected workflow and produces the correct final output. | ||
| - Discoverability: checks whether the agent loads the skill when relevant and avoids using it when irrelevant. | ||
| - Effectiveness: checks whether the agent performs measurably better with the skill than without it. | ||
| - Efficiency: checks whether the agent uses fewer tokens and avoids redundant work. | ||
|
|
||
| Underlying evaluation signals used in this run: | ||
|
|
||
| - `security` (Security): checks for unsafe operations, secret leakage, and unauthorized access. | ||
| - `skill_execution` (Skill Execution): verifies that the agent loaded the expected skill and workflow. | ||
| - `skill_efficiency` (Efficiency): checks routing quality, decoy avoidance, and redundant tool usage. | ||
| - `accuracy` (Accuracy): grades final-answer correctness against the reference answer. | ||
| - `goal_accuracy` (Goal Accuracy): checks whether the overall user task completed successfully. | ||
| - `behavior_check` (Behavior Check): verifies expected behavior steps, including safety expectations. | ||
| - `token_efficiency` (Token Efficiency): compares token usage with and without the skill. | ||
|
|
||
| ## Test Tasks | ||
|
|
||
| The benchmark dataset contained 1 evaluation tasks: | ||
|
|
||
| - Positive tasks: 1 tasks where the skill was expected to activate. | ||
| - Negative tasks: 0 tasks where no skill was expected. | ||
| - Unlabeled tasks: 0 tasks where positive/negative intent could not be inferred. | ||
|
|
||
| Task composition is derived from the evaluation dataset when possible. Entries with `expected_skill` set are treated as positive skill-activation cases, while entries with `expected_skill: null` are treated as negative activation cases. | ||
|
|
||
| ## Results | ||
|
|
||
| | Dimension | Num | `claude-code` | `codex` | | ||
| |---|---:|---:|---:| | ||
| | Security | 2 | 100% (+0%) | 100% (+0%) | | ||
| | Correctness | 2 | 100% (+0%) | 97% (+5%) | | ||
| | Discoverability | 2 | 100% (+0%) | 84% (+5%) | | ||
| | Effectiveness | 2 | 78% (+2%) | 76% (+4%) | | ||
| | Efficiency | 2 | 93% (-0%) | 78% (-0%) | | ||
|
|
||
| Score values show skill-assisted performance. Values in parentheses show uplift versus the no-skill baseline when baseline data is available. | ||
|
|
||
| ## Tier 1: Static Validation Summary | ||
|
|
||
| Tier 1 validation passed with observations. NVSkills-Eval ran 9 checks and found 8 total findings. | ||
|
|
||
| Top findings: | ||
|
|
||
| - MEDIUM SCHEMA/body_recommended_section: Missing recommended section: '## Instructions' (`skills/cuopt-numerical-optimization-api-cli/SKILL.md`) | ||
| - LOW QUALITY/quality_discoverability: Broad description without negative triggers may cause over-triggering (`skills/cuopt-numerical-optimization-api-cli/SKILL.md`) | ||
| - LOW QUALITY/quality_discoverability: No '## Purpose' section (`skills/cuopt-numerical-optimization-api-cli/SKILL.md`) | ||
| - LOW QUALITY/quality_reliability: No prerequisites/requirements documented (`skills/cuopt-numerical-optimization-api-cli/SKILL.md`) | ||
| - LOW QUALITY/quality_reliability: No limitations documented (`skills/cuopt-numerical-optimization-api-cli/SKILL.md`) | ||
|
|
||
| ## Tier 2: Deduplication Summary | ||
|
|
||
| Tier 2 validation passed. NVSkills-Eval ran 2 checks and found 0 total findings. | ||
|
|
||
| Notable observations: | ||
|
|
||
| - Context Deduplication: Collected 5 file(s) | ||
| - Inter-Skill Deduplication: Parsed skill 'cuopt-numerical-optimization-api-cli': 141 char description | ||
|
|
||
| ## Publication Recommendation | ||
|
|
||
| The skill is suitable to proceed toward NVSkills-Eval publication based on this benchmark. Skill owners should keep this file with the skill and refresh it when the evaluation dataset, skill behavior, or target agents materially change. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a blank line before the evaluation results table.
The table starts immediately after the heading, which triggers MD058 (
blanks-around-tables). Please insert one blank line between the heading and the table.🛠️ Suggested fix
## Evaluation Results: <br> + | Dimension | Num | `claude-code` | `codex` | |---|---:|---:|---:|As per coding guidelines, "Use
pre-commit run --all-files --show-diff-on-failureto check code formatting and linting on all files before committing".📝 Committable suggestion
🧰 Tools
🪛 markdownlint-cli2 (0.22.1)
[warning] 62-62: Tables should be surrounded by blank lines
(MD058, blanks-around-tables)
🤖 Prompt for AI Agents