orkcore-python

Answer questions about orkid's Python binding system, pybind11 integration, type codec, VarMap bindings, gilsafepyobj, factory patterns (wfactory/uifactory), and module initialization. Use when the user asks about Python bindings, pybind11 patterns, GIL safety, or type conversion.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tweakoz/orkid/orkcore-python
Any agent
npx skills add tweakoz/orkid --skill orkcore-python
Clone the repo
git clone --depth 1 https://github.com/tweakoz/orkid

Made for: Claude Code, Codex.

Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,049 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00066 $0.02049
Opus 5 $0.00033 $0.01025
Sonnet 5 $0.00013 $0.00410
Haiku 4.5 $0.00007 $0.00205

Measured today against content hash ba36f7889cb1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

orkcore-python scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

return cat->fetch(id);
.claude/skills/orkcore-python/SKILL.md · 215 lines

How it starts

The opening of the file, as written. The whole thing — 215 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Orkid Python Binding System Reference

When answering questions about Python bindings in orkid, consult these files.

Key Files

Component Location
Type Codec Header ork.core/inc/ork/python/pycodec.h
Type Codec Impl ork.core/inc/ork/python/pycodec.inl
pybind11 Adapter ork.core/inc/ork/python/pycodec_pybind11.inl
GIL-Safe Wrapper ork.core/inc/ork/python/gil_safe_pyobj.h
Unmanaged Pointers ork.core/inc/ork/python/wraprawpointer.inl
VarMap Bindings ork.core/inc/ork/python/common_bindings/pyext_varmap.inl
Math Bindings ork.core/inc/ork/python/common_bindings/pyext_math_la.inl
CrcString Bindings ork.core/inc/ork/python/common_bindings/pyext_crcstring.inl
Core pyext.h ork.core/pyext/pyext.h
Lev2 pyext.h ork.lev2/pyext/src/pyext.h
Module Init (lev2) ork.lev2/pyext/src/pyext.cpp
UI Bindings ork.lev2/pyext/src/pyext_ui.cpp
Toolbar Bindings ork.lev2/pyext/src/pyext_ui_toolbar.cpp

Architecture Overview

Type Codec (pb11_typecodec_t)

Central type conversion between C++ and Python:

auto type_codec = python::pb11_typecodec_t::instance();

// Encode C++ → Python
py::object py_val = type_codec->encode(svar128_value);

// Decode Python → C++
svar128_t cpp_val = type_codec->decode(py_object);

// Register custom type
type_codec->registerStdCodec<my_ptr_t>(my_pybind_type);

Module Initialization Pattern

void pyinit_my_module(py::module& parent_module) {
  auto type_codec = python::pb11_typecodec_t::instance();
  
  auto my_type = py::class_<MyClass, myclass_ptr_t>(parent_module, "MyClass")
    .def(py::init<>())
    .def("method", ...)
    .def_property("prop", getter, setter);
  
  type_codec->registerStdCodec<myclass_ptr_t>(my_type);
}

Factory Patterns (Widget Creation)

Three standard factories on UI widget types:

// wfactory — standalone widget (for overlays, manual composition)
.def_static("wfactory", [type_codec](py::list py_args) -> widget_ptr_t {
  auto decoded_args = type_codec->decodeList(py_args);
  auto name = decoded_args[0].get<std::string>();
  return std::make_shared<MyWidget>(name);
})

// uifactory — add to layout group (returns layout item)
.def_static("uifactory", [type_codec](uilayoutgroup_ptr_t lg, py::list py_args) -> uilayoutitem_ptr_t {
  auto decoded_args = type_codec->decodeList(py_args);
  auto name = decoded_args[0].get<std::string>();
  return lg->makeChild<MyWidget>(name).as_shared();
})

Read the full file on GitHub · 215 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 215 lines · 66 tokens per session scan A ba36f7889cb1

Subscribe to this mod's changes

orkcore-python is a skill published in the GitHub repository tweakoz/orkid (35 stars, last pushed 19d ago), licensed MIT. It adds 66 tokens to every session and 2,049 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-01.

Related

Other skills, from other repositories

creating-components

Use when creating new UI components in packages/ui. Covers component structure, tests, stories, and what to avoid.

nukeop/nuclear · 26 tokens

host-pattern

Use when adding a new domain to Nuclear's plugin system, or implementing a host. Covers the host pattern (how player functionality is exposed to plugins), the host interface and API class structure, how hosts are implemented in the player, error handling conventions, and what files to create and modify. Trigger…

nukeop/nuclear · 86 tokens

writing-docs

Use when writing or editing documentation in packages/docs. Covers Gitbook markdown syntax, special blocks, page structure, and the SUMMARY.md table of contents. Trigger phrases include "write docs", "add documentation", "docs page", "gitbook", "user manual".

nukeop/nuclear · 57 tokens

writing-plugins

Use when writing, scaffolding, or modifying Nuclear plugins. Covers plugin structure, manifest, entry point, provider types, available APIs, and publishing. Trigger phrases include "create a plugin", "write a plugin", "plugin scaffold", "streaming provider", "metadata provider".

nukeop/nuclear · 60 tokens

analyzing-linux-elf-malware

Analyze malicious Linux ELF binaries — botnets, cryptominers, ransomware, and rootkits targeting Linux servers, containers, and cloud infrastructure — through static analysis, dynamic tracing, and reverse engineering of x8664 and ARM samples. Use when investigating Linux malware, triaging a suspicious ELF binary…

mukul975/Anthropic-Cybersecurity-Skills · 82 tokens

analyzing-linux-kernel-rootkits

Detect kernel-level rootkits in Linux memory dumps using Volatility3 linux plugins (checksyscall, lsmod, hiddenmodules), rkhunter system scanning, and /proc vs /sys discrepancy analysis to identify hooked syscalls, hidden kernel modules, and tampered system structures.

mukul975/Anthropic-Cybersecurity-Skills · 65 tokens