sarman/dgx-spark-playbooks
1
0
Fork 0
mirror of https://github.com/NVIDIA/dgx-spark-playbooks.git synced 2026-04-23 02:23:53 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: add Claude Code marketplace install + README instructions

Browse Source 
Adds .claude-plugin/marketplace.json so the repo can be installed as a
Claude Code plugin via:

  /plugin marketplace add jkneen/dgx-spark-playbooks
  /plugin install dgx-spark-playbooks@dgx-spark-playbooks

Documents both the marketplace path and the local git clone + install.sh
path in the README, including how to customize skills via overrides/.
This commit is contained in:
Jason Kneen 2026-04-19 10:32:56 +01:00
parent 3e9a50b48c
commit 684559d190
2 changed files with 47 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
.claude-plugin/marketplace.json Normal file
View File

@ -0,0 +1,14 @@
{
"name": "dgx-spark-playbooks",
"owner": {
"name": "Jason Kneen",
"email": "jason@bouncingfish.com"
},
"plugins": [
{
"name": "dgx-spark-playbooks",
"source": "./",
"description": "Skills for setting up AI/ML workloads on NVIDIA DGX Spark hardware — derived from the official DGX Spark playbooks."
}
]
}

33
README.md
View File

@ -17,6 +17,39 @@ These playbooks provide detailed instructions for:
Each playbook includes prerequisites, step-by-step instructions, troubleshooting guidance, and example code.
## Use as Claude Code Skills
Every playbook in this repo is also exposed as a [Claude Code](https://docs.claude.com/claude-code) skill, so Claude can install and configure them for you interactively. An index skill (`dgx-spark`) routes broad questions to the right specific playbook, and each leaf skill carries cross-references to related playbooks (prerequisites, alternatives, what to try next).
### Option A: install via Claude Code plugin marketplace (recommended)
In Claude Code, run:
```
/plugin marketplace add jkneen/dgx-spark-playbooks
/plugin install dgx-spark-playbooks@dgx-spark-playbooks
```
### Option B: install locally via script
Clone and run the install script. This symlinks each skill into `~/.claude/skills/`, so `git pull` updates them in place.
```bash
git clone https://github.com/jkneen/dgx-spark-playbooks
cd dgx-spark-playbooks
./scripts/install.sh # individual skills → ~/.claude/skills/
./scripts/install.sh --plugin # or: whole repo as a plugin → ~/.claude/plugins/
./scripts/uninstall.sh # remove
```
Requires Node 18+ if you want to regenerate skills from overrides; otherwise the committed `skills/` directory is used as-is.
### Customizing a skill
Hand-curate any skill by creating or editing `overrides/<playbook-name>.md` (see [`overrides/ollama.md`](overrides/ollama.md) as a worked example), then run `node scripts/generate.mjs` to rebuild. Overrides contribute the frontmatter `description` (which controls when the skill triggers) and any extra sections like "Related skills" or gotchas. Generated content between `<!-- GENERATED:BEGIN -->` and `<!-- GENERATED:END -->` markers is rewritten from the upstream README on every regeneration; override content outside those markers is preserved.
A GitHub Action auto-regenerates `skills/` whenever a playbook README or override changes.
## Available Playbooks
### NVIDIA