customize-pythinkerlisted

# Customize Pythinker Authoritative, offline schema for editing Pythinker's own configuration surface. Pythinker **hard-fails on a malformed config**, so get the schema right the first time. This skill covers the config surfaces no other builtin skill owns. Out of scope: authoring agents (use `agent-creator`), authoring skills (use `skill-creator`). Always verify a value against the real schema before writing it. After any edit, confirm Pythinker still starts (a malformed file aborts startup). ## Agent YAML (`agentspec.py`) An agent spec is a YAML file with a separate system-prompt markdown file. Inheritance lets a project agent extend the builtin one. | Field | Type | Notes | |---|---|---| | `extend` | str | Agent file to inherit from. `"default"` inherits the builtin agent. Child fields override parent; `system_prompt_args` merge by key; `subagents` merge with child entries winning. | | `name` | str | Required (or inherited via `extend`). | | `system_prompt_path` | path | Required; resolved relative to the YAML file. | | `system_prompt_args` | dict[str,str] | Conventionally carries `ROLE_ADDITIONAL` (persona text). Merged when extending. | | `tools` | list[str] | `module:ClassName` form, e.g. `pythinker_code.tools.file:ReadFile`. | | `allowed_tools` / `exclude_tools` | list[str] | Narrow the inherited/declared tool set. | | `model` | str | Optional model alias. | | `mode` | `primary` \| `subagent` \| `all` \| `hidden` | Defaults to `primary`. | | `hidden` | bool | Opti