Skip to content

Add install-and-verify plugin skill#75

Merged
amazloumi merged 3 commits intomainfrom
feat/install-and-verify-skill
Apr 30, 2026
Merged

Add install-and-verify plugin skill#75
amazloumi merged 3 commits intomainfrom
feat/install-and-verify-skill

Conversation

@amazloumi
Copy link
Copy Markdown
Member

@amazloumi amazloumi commented Apr 30, 2026

Summary

New /kempnerforge:install-and-verify skill — runs uv sync and the four CI gate checks (ruff check, ruff format --check, pyright, pytest tests/unit/). On non-CUDA hosts (macOS, CPU-only Linux) it appends --no-sources to bypass the CUDA-only torch wheel pin and warns the user that this venv is dev-only.

Skill catalog grows from six to seven. README.md, kempnerforge/README.md, and docs/claude-ready.md updated; CHANGELOG records the addition.

Testing

  • Validated end-to-end on macOS arm64 (non-CUDA path) by a fresh-context Claude Code agent: 892 unit tests pass; ruff / pyright clean; CUDA detection + --no-sources warning behave as documented.
  • uv run ruff check kempnerforge/ tests/ passes
  • uv run ruff format --check kempnerforge/ tests/ scripts/ passes
  • uv run pyright kempnerforge/ passes (0 errors)
  • uv run pytest tests/unit/ -v --timeout=60 passes
  • [N/A] If distributed code changed: uv run torchrun --nproc_per_node=4 -m pytest tests/distributed/ -v
  • [N/A] If training loop / parallelism / optimizers changed: uv run pytest tests/e2e/ --e2e -v

Notes

Stacked on PR #72.

@amazloumi amazloumi requested review from Naeemkh and mmshad April 30, 2026 18:09
@amazloumi amazloumi changed the base branch from main to feat/python-version-pin April 30, 2026 18:13
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 30, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

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

Copy link
Copy Markdown
Member

@Naeemkh Naeemkh left a comment

Choose a reason for hiding this comment

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

Thanks, @amazloumi, please see the comments.

Comment thread kempnerforge/README.md Outdated
The `marketplace list` step is a sanity check: `kempnerforge` should appear under "Configured marketplaces". If it doesn't, the add silently failed; re-check the absolute path.

v0.1 ships six skills: `cluster-config`, `smoke-test`, `slurm-launch`, `explain-architecture`, `add-optimizer`, `component-gaps`. Full catalog, install details, and how skills stay in sync with the code: [`docs/claude-ready.md`](docs/claude-ready.md).
v0.1 ships seven skills: `install-and-verify`, `cluster-config`, `smoke-test`, `slurm-launch`, `explain-architecture`, `add-optimizer`, `component-gaps`. Full catalog, install details, and how skills stay in sync with the code: [`docs/claude-ready.md`](docs/claude-ready.md).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Let's drop the number (seven here), so future updates does not need to change this number.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

done


## When to use
- Right after `git clone`, before any other skill.
- After `git pull` brings new dependency changes (`pyproject.toml` or `uv.lock`).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This can be too much during development and time consuming, I understand running it once after git clone, but after each git pull is too much. You might consider changing the wording to

Optionally after git pull if the user asks for it. 

Also mention to run it in the background as subprocess.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

done


On `NO_CUDA`, **print this warning to the user verbatim** before proceeding, and append `--no-sources` to every `uv run` and `uv sync` invocation in this skill (the flag is per-command, not sticky):

> ⚠️ No CUDA GPU detected. Using `--no-sources` to fetch torch from PyPI instead of the CUDA wheel index. Sufficient for the dev loop (lint, type-check, CPU unit tests); training and GPU tests still need a Linux GPU box. Note: `--no-sources` also bypasses any other `[tool.uv.sources]` entries the project may add later.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Let's drop emojis.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

done

Comment thread README.md Outdated
The `marketplace list` step is a sanity check: `kempnerforge` should appear under "Configured marketplaces". If it doesn't, the add silently failed; re-check the absolute path.

v0.1 ships six skills: `cluster-config`, `smoke-test`, `slurm-launch`, `explain-architecture`, `add-optimizer`, `component-gaps`. Full catalog, install details, and how skills stay in sync with the code: [`docs/claude-ready.md`](docs/claude-ready.md).
v0.1 ships seven skills: `install-and-verify`, `cluster-config`, `smoke-test`, `slurm-launch`, `explain-architecture`, `add-optimizer`, `component-gaps`. Full catalog, install details, and how skills stay in sync with the code: [`docs/claude-ready.md`](docs/claude-ready.md).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Also here, please drop the number (seven here).

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

done

Base automatically changed from feat/python-version-pin to main April 30, 2026 18:40
@amazloumi amazloumi requested a review from Naeemkh April 30, 2026 19:12
@amazloumi amazloumi merged commit 9a17d2a into main Apr 30, 2026
6 checks passed
@amazloumi amazloumi deleted the feat/install-and-verify-skill branch April 30, 2026 22:26
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