Skip to content

Commit d59b154

Browse files
TMHSDigitalclaude
andcommitted
docs: one consistent Claude Code install path, plus updating and uninstalling
- README Overview said "Claude Code reads skills/ and rules/ from the project workspace", contradicting Quick start ("Claude Code does not read Cursor .mdc rules"). It now describes the plugin for skills and the generated claude/blender-rules.md for rules. CLAUDE.md's "copy skills/ and rules/ into the project workspace" (pre-#289 text) is replaced the same way. - "install the plugin (see Install)" pointed at a section that does not exist; it now links Quick start. - New "Updating and uninstalling" subsection: /plugin marketplace update (and `claude plugin update` from a shell), /plugin uninstall and marketplace remove; git pull for a checkout; symlink rather than copy Cursor rules so they do not go stale; how to remove the rules import. Closes #335 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 2bd2041 commit d59b154

2 files changed

Lines changed: 10 additions & 3 deletions

File tree

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ touching `examples/`; the landing page builds from `scripts/site/` at deploy tim
215215
The AI consumes content via:
216216

217217
- **Cursor**: rules under `rules/` apply when scope globs match. Skills are referenced by name in chat.
218-
- **Claude Code**: copy `skills/` and `rules/` into the project workspace, or use this repo as a checkout that Claude Code references directly.
218+
- **Claude Code**: install the plugin (`.claude-plugin/`, README Quick start) for the skills. Claude Code does not read `.mdc` rules; it gets them through `claude/blender-rules.md`, generated from `rules/` by `scripts/build_claude_rules.py`.
219219

220220
## Key Conventions
221221

‎README.md‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@
4343

4444
This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 64 examples, and 76 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
4545

46-
The content is consumed by AI coding agents reading these files directly from a checkout — **there is no MCP server in this repository, and none is required**. Cursor applies `rules/*.mdc` automatically wherever their scope globs match and takes skills by name in chat; Claude Code reads `skills/` and `rules/` from the project workspace, or from this repo kept as a referenced checkout. Any agent that can read files in a workspace can use it the same way. There is no build step for the content — edit the Markdown and Python files directly.
46+
The content is consumed by AI coding agents reading these files directly from a checkout — **there is no MCP server in this repository, and none is required**. Cursor applies `rules/*.mdc` automatically wherever their scope globs match and takes skills by name in chat; Claude Code installs the skills as a plugin and reads the rules through a generated summary (see [Quick start](#quick-start)), since it does not read Cursor `.mdc` files. Any agent that can read files in a workspace can use it the same way. There is no build step for the content — edit the Markdown and Python files directly.
4747

4848
| Layer | Role |
4949
| --- | --- |
@@ -76,6 +76,13 @@ git clone https://github.com/TMHSDigital/Blender-Developer-Tools.git
7676
blender --background --python examples/bmesh-gear/bmesh_gear.py --
7777
```
7878

79+
### Updating and uninstalling
80+
81+
Releases ship often; [CHANGELOG.md](CHANGELOG.md) lists what each one changed.
82+
83+
- **Claude Code plugin** — `/plugin marketplace update blender-developer-tools` refreshes the marketplace and its plugins (from a shell: `claude plugin update blender-developer-tools@blender-developer-tools`). Remove it with `/plugin uninstall blender-developer-tools`, then `/plugin marketplace remove blender-developer-tools`.
84+
- **Checkout** (Cursor rules, the Claude rules import, examples) — `git pull` in the clone. Copied `.mdc` files do not update themselves: symlink `rules/*.mdc` into `.cursor/rules/` instead of copying, or re-copy after each pull. To uninstall, delete the copied or linked rules and the `@.../blender-rules.md` line from your `CLAUDE.md`.
85+
7986
## Supported Blender versions
8087

8188
| Version | Status |
@@ -1479,7 +1486,7 @@ The `.mdc` files in `rules/` apply automatically when Cursor opens a Blender Pyt
14791486
- `no-unapplied-modifiers-on-export`: flags export of objects with live modifiers when the export does not request evaluated geometry
14801487
- `use-correct-axis-rna-per-exporter`: flags `export_scene.gltf` calls that pass FBX `axis_forward` / `axis_up`, and `export_scene.fbx` calls that pass glTF `export_yup`
14811488

1482-
Cursor: copy `rules/*.mdc` into `.cursor/rules/`. Claude Code: install the plugin (see Install) and import `claude/blender-rules.md` from your `CLAUDE.md`.
1489+
Cursor: copy `rules/*.mdc` into `.cursor/rules/`. Claude Code: install the plugin (see [Quick start](#quick-start)) and import `claude/blender-rules.md` from your `CLAUDE.md`.
14831490

14841491
## Using the templates
14851492

0 commit comments

Comments
 (0)