Skip to content

Commit 91c5d84

Browse files
TMHSDigitalclaude
andcommitted
docs(readme): lead with what the pack does for an AI agent, and how to install it
The README opened with "Skills, rules, snippets, templates, and runnable examples for Blender Python development" and three rows of badges, so a visitor could not tell in ten seconds that this is an agent pack; the Claude Code /plugin listing described it as "Cursor and Claude Code skills ..." with no outcome. The first screen now states the outcome, names three failures the pack prevents (each one measured in this repo: context.copy() overrides, action.fcurves on 5.x, Z-up glTF), shows the two-line Claude Code install, and keeps one badge row; the license badge shows the MIT carve out for code. The Overview no longer says Cursor takes skills "by name in chat". The Claude plugin and marketplace descriptions are outcome-first. Counts wording is unchanged (validate-counts greps it). Closes #370 Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 7df9a19 commit 91c5d84

3 files changed

Lines changed: 10 additions & 49 deletions

File tree

‎.claude-plugin/marketplace.json‎

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +0,0 @@
1-
{
2-
"name": "blender-developer-tools",
3-
"owner": {
4-
"name": "TMHSDigital",
5-
"url": "https://github.com/TMHSDigital"
6-
},
7-
"plugins": [
8-
{
9-
"name": "blender-developer-tools",
10-
"source": {
11-
"source": "github",
12-
"repo": "TMHSDigital/Blender-Developer-Tools",
13-
"ref": "plugin-dist"
14-
},
15-
"description": "Cursor and Claude Code skills, rules, snippets, and templates for Blender Python add-on and scripting development",
16-
"version": "0.143.9"
17-
}
18-
]
19-
}

‎.claude-plugin/plugin.json‎

Lines changed: 0 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +0,0 @@
1-
{
2-
"name": "blender-developer-tools",
3-
"description": "Cursor and Claude Code skills, rules, snippets, and templates for Blender Python add-on and scripting development",
4-
"version": "0.143.9",
5-
"author": {
6-
"name": "TMHSDigital",
7-
"url": "https://github.com/TMHSDigital"
8-
},
9-
"homepage": "https://github.com/TMHSDigital/Blender-Developer-Tools",
10-
"repository": "https://github.com/TMHSDigital/Blender-Developer-Tools",
11-
"license": "CC-BY-NC-ND-4.0 AND MIT",
12-
"skills": [
13-
"./claude/skills/"
14-
],
15-
"keywords": [
16-
"claude-code",
17-
"blender",
18-
"bpy",
19-
"blender-addon",
20-
"blender-python",
21-
"developer-tools"
22-
]
23-
}

‎README.md‎

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,25 @@
33
---
44

55
<p align="center">
6-
<strong>Skills, rules, snippets, templates, and runnable examples for Blender Python development</strong>
6+
<strong>Teach Cursor and Claude Code the Blender Python that actually runs on Blender 5.2 LTS and 4.5 LTS.</strong>
77
</p>
88

99
<p align="center">
10-
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/releases"><img src="https://img.shields.io/github/v/release/TMHSDigital/Blender-Developer-Tools?style=flat-square&color=e87d0d&label=release" alt="Release" /></a>
11-
<a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-384d54?style=flat-square" alt="License" /></a>
10+
Skills and rules that stop AI agents writing the <code>bpy</code> that breaks: <code>bpy.context.copy()</code> operator overrides (removed in 4.0), <code>action.fcurves</code> on 5.x Slotted Actions, glTF exports that land on their back in every engine. Each contract is backed by a headless example that is smoke-tested on both LTS versions.
1211
</p>
1312

1413
<p align="center">
15-
<a href="https://github.com/sponsors/TMHSDigital"><img src="https://img.shields.io/badge/sponsor-%E2%99%A5-ea4aaa?style=flat-square&logo=githubsponsors&logoColor=white" alt="Sponsor TMHSDigital on GitHub Sponsors" /></a>
14+
<code>/plugin marketplace add TMHSDigital/Blender-Developer-Tools@plugin-dist</code><br />
15+
<code>/plugin install blender-developer-tools@blender-developer-tools</code><br />
16+
<sub>Claude Code. Cursor and other agents: <a href="#quick-start">Quick start</a>.</sub>
1617
</p>
1718

1819
<p align="center">
19-
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Blender-Developer-Tools/validate.yml?branch=main&style=flat-square&label=validate" alt="Validate" /></a>
20+
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/releases"><img src="https://img.shields.io/github/v/release/TMHSDigital/Blender-Developer-Tools?style=flat-square&color=e87d0d&label=release" alt="Release" /></a>
2021
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/actions/workflows/blender-smoke.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Blender-Developer-Tools/blender-smoke.yml?branch=main&style=flat-square&label=blender%204.5%20%2B%205.2%20smoke" alt="Blender smoke tests" /></a>
21-
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/actions/workflows/drift-check.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Blender-Developer-Tools/drift-check.yml?branch=main&style=flat-square&label=drift-check" alt="Drift check" /></a>
22+
<a href="https://github.com/TMHSDigital/Blender-Developer-Tools/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Blender-Developer-Tools/validate.yml?branch=main&style=flat-square&label=validate" alt="Validate" /></a>
23+
<a href="#license"><img src="https://img.shields.io/badge/license-CC%20BY--NC--ND%204.0%20%2B%20MIT%20code-384d54?style=flat-square" alt="License: CC BY-NC-ND 4.0, with snippets and templates under MIT" /></a>
24+
<a href="https://github.com/sponsors/TMHSDigital"><img src="https://img.shields.io/badge/sponsor-%E2%99%A5-ea4aaa?style=flat-square&logo=githubsponsors&logoColor=white" alt="Sponsor TMHSDigital on GitHub Sponsors" /></a>
2225
</p>
2326

2427
<p align="center">
@@ -43,7 +46,7 @@
4346

4447
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.
4548

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.
49+
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**. Both agents install it as a plugin (see [Quick start](#quick-start)): Cursor loads the skills and applies `rules/*.mdc` wherever their scope globs match; Claude Code loads the skills and gets the rules through a generated `blender-rules` skill, since it does not read Cursor `.mdc` files. An agent picks a skill up when its description matches the task. 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.
4750

4851
| Layer | Role |
4952
| --- | --- |

0 commit comments

Comments
 (0)