Skip to content

Add bhom-python Claude Code skill for writing, testing and reviewing Python - #265

Open
Felix-Mallinder wants to merge 12 commits into
developfrom
Python_Toolkit-#264-AddBHoMPythonClaudeSkill
Open

Felix-Mallinder wants to merge 12 commits into
developfrom
Python_Toolkit-#264-AddBHoMPythonClaudeSkill

Conversation

@Felix-Mallinder

@Felix-Mallinder Felix-Mallinder commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Issues addressed by this PR

Closes #264

Adds a Claude Code skill in .claude/skills/bhom-python/ that guides how Python in Python_Toolkit is written, tested and reviewed:

  • SKILL.md: overview, golden rules and decision tree
  • SKILL-IMPLEMENTATION.md: package layout, packaging and style rules
  • SKILL-FRAMEWORK.md: bhom_wrapper.bhom_callable + run_wrapped as the route from C# into Python, BHoMObject/IObject and BHoM JSON, logging, bhom_analytics and pythonnet
  • SKILL-TESTING.md: pytest standards, including tests for wrapped (C#-callable) methods
  • SKILL-REVIEW.md: compliance rule catalogue (PY-xxx) and review report format

Also adds .claude/skills/bhom-branch-naming/, a skill for naming branches <Project>-#<IssueNumber>-<PascalCaseDescription>.

This PR is documentation only. No code changes.

Test files

None needed. The code examples and the C# -> run_wrapped contract described in SKILL-FRAMEWORK.md were checked against develop (d9d1edd) in an installed Python_Toolkit/v3_10 environment.

To try it: open this repo in Claude Code and ask it to add a small helper plus a C#-callable wrapper with tests, or to review bhom/decorators/_bhom_callable_decorator.py.

Changelog

  • Added bhom-python Claude Code skill for writing, testing and reviewing Python in Python_Toolkit.

Additional comments

Review decisions are applied in the skill text (see each skill's CHANGELOG.md). Still open, tracked in #264: test location, the wrapped-method identifier convention, and lint/CI configuration.

🤖 Generated with Claude Code

Draft (v0.2.0, for QA) Claude Code skill covering Python in Python_Toolkit:
- SKILL.md: overview, golden rules, decision tree
- SKILL-IMPLEMENTATION.md: package layout, packaging, style rules
- SKILL-FRAMEWORK.md: bhom_callable + run_wrapped as the only C# route,
  BHoMObject/IObject and BHoM JSON, logging, analytics, pythonnet,
  known framework defects on develop
- SKILL-TESTING.md: pytest standards, wrapped-method test patterns
- SKILL-REVIEW.md: compliance rule catalogue and review report format
- QA-NOTES.md: open decisions for reviewers (remove before release)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…defects

- Console-logger-on-stdout defect now references the UV environment
  management update (#253), where the C# run method returns stdout and
  stderr separately, instead of an open question about moving to stderr.
- Removed references to defects already fixed on develop.
- Bumped SKILL-FRAMEWORK, SKILL-IMPLEMENTATION and CHANGELOG to 0.2.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… value

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Felix-Mallinder and others added 2 commits November 18, 2026 12:15
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@Felix-Mallinder Felix-Mallinder left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

we don't need the QA notes file to be merged

@Felix-Mallinder Felix-Mallinder left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

We should be authoring these filesBHoM

@Felix-Mallinder
Felix-Mallinder marked this pull request as ready for review November 19, 2026 09:20
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.

Add bhom-python Claude Code skill for writing, testing and reviewing Python

2 participants