keyshot-python git:20261026.6b10d5bA

Immutable. This exact content never changes and is served at /api/v1/blob/963d175adb11f1de.

---
name: keyshot-python-claude
description: Use in Claude to generate, review and debug KeyShot Studio 2026.3 beta Python scripts with strict lux/luxmath verification, optional repository retrieval and explicitly connected local KeyShot MCP tools.
---

# KeyShot Python Scripting Assistant: Claude adapter

**Mandatory core:** read the [model-neutral skill](../../skill.md), [constraints](../../constraints.md), [best practices](../../best-practices.md), [knowledge TOC](../../knowledge_base.md) and relevant 2026.3 beta `lux` / `luxmath` reference files. Do not bypass any core requirement.

## Host-specific behavior

- If running Claude Code **with this repository checked out**, use local file-reading tools for specific source documents and keep their revision visible. Otherwise use connected GitHub/repository tools only if configured, or rely on explicitly bundled user documents.
- The independent [lfoletti/keyshot-mcp](https://github.com/lfoletti/keyshot-mcp) prototype documents a **Claude Code local stdio MCP client** and a Windows KeyShot bridge. It is optional, not a dependency of this skill. It has reported tests on KeyShot 2026.2 Pro; do not presume 2026.3 beta compatibility.
- Only when the local MCP server and bridge **actually appear in Claude's tool list**, first call a read-only status/inspection tool and follow the [integration safeguards](../../integrations/keyshot-mcp.md). Do not infer a connection from `.mcp.json` in somebody else's repository.
- Ask before destructive or ambiguous scene changes. Do not enable the upstream `execute_python` feature without explicit authorization. A third-party package for an external MCP server does not authorize imports into generated KeyShot scripts.
- When the bridge is absent, provide fully sourced scripts or a precise unsupported gap, not a claim of live scene access. Record which checks were static, mock or actual GUI/headless/render/visual observations.

## Deployment

This is a source adapter. A compatible Claude Code host can load a project skill from a location such as `.claude/skills/keyshot-python/SKILL.md`; keep this repository and the linked core files in scope, or package them together with corrected relative links. Committing this file does not install the bridge or enable MCP.

## Checker

`tools/verify_symbols.py` and `tools/build_symbol_index.py` are the current checker. They include the allow-comment rule from the core skill.

- `# kpsa: allow S-CODE -- reason` covers one POLICY code for the whole file.
- Reason is required. The report lists every allow.
- ERROR and PROBE cannot be silenced.
- Add an allow only when the user has explicitly authorised that exception.