From 2cd3774aad7a2824b38d2b80fd6104cade239c2e Mon Sep 17 00:00:00 2001 From: Zwitschi Date: Tue, 10 Nov 2026 17:58:34 +0100 Subject: [PATCH] docs(skills): all skill packs are gitignored, none committed The owner added /.agents/skills/ to .gitignore, so no skill is in the repository: the UE packs, the cpp router and blender-director are all local-only. Reconcile the docs that still said 'in the repository': - AGENTS.md: blender-director and the UE packs now say gitignored, not committed. - Docs/toolchain.md: drop the stale 'in this repository' row and name the UE and C++ sources in the table. - MEMORY.md: record the decision. --- AGENTS.md | 4 ++-- Docs/toolchain.md | 6 ++++-- MEMORY.md | 10 ++++++++++ 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 60e4b0f..9f9da1f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -181,7 +181,7 @@ Always use a consistent scale test, named export presets, and repeatable import The 93 upstream Blender skill packs (MIT, blender-skills 1.3.0) live once, in the **common** agent folder `~/.pi/agent/skills/`, together with the shared `references/` notes and the upstream `LICENSE`. They are agent instructions, not add-ons, and nothing in the pipeline depends on them. -Only the project-specific pack stays in the repository: `.agents/skills/blender-skills/blender-director/` — the pipeline orchestrator, which names this project's tools and stages. It refers to the shared notes by absolute path (`~/.pi/agent/skills/references/…`). +The project-specific pack, `.agents/skills/blender-skills/blender-director/` — the pipeline orchestrator, which names this project's tools and stages — also stays **out of the repository**: `/.agents/skills/` is gitignored. It refers to the shared notes by absolute path (`~/.pi/agent/skills/references/…`). Do not copy the common packs into the repository: a second copy under a different root is a name collision, and Pi keeps the first one it finds and warns on every start. Add a pack to `~/.pi/agent/skills//SKILL.md` (one level down, flat) and it is picked up everywhere; `references/` sits beside them at `~/.pi/agent/skills/references/`. @@ -199,7 +199,7 @@ Do not copy the common packs into the repository: a second copy under a differen ## Unreal Engine skills -The 31 Unreal Engine skill packs (MIT, [quodsoler/unreal-engine-skills](https://github.com/quodsoler/unreal-engine-skills) `f3742d7`) live in the repository at `.agents/skills/ue-*/` and target **UE 5.8 C++**. Each carries API examples verified against the 5.8 headers plus a deprecated-API table that maps old calls to the 5.8 forms. They are agent instructions, not add-ons. +The 31 Unreal Engine skill packs (MIT, [quodsoler/unreal-engine-skills](https://github.com/quodsoler/unreal-engine-skills) `f3742d7`) live locally at `.agents/skills/ue-*/` (gitignored, not committed) and target **UE 5.8 C++**. Each carries API examples verified against the 5.8 headers plus a deprecated-API table that maps old calls to the 5.8 forms. They are agent instructions, not add-ons. `.agents/skills/ue-project-context/` is the entry point: it writes `.agents/ue-project-context.md` (module names, conventions, enabled plugins), and every other UE skill reads that file first. Refresh it when the project changes — new module, new plugin, engine bump — before consulting the rest. diff --git a/Docs/toolchain.md b/Docs/toolchain.md index b6735bd..56e9245 100644 --- a/Docs/toolchain.md +++ b/Docs/toolchain.md @@ -34,10 +34,12 @@ Unreal Engine 5.9 is in preview and Unreal Engine 6 has been announced as of Nov | Package | blender-skills `1.3.0`, upstream commit `8f778d2`, MIT | | Source | | | Location | Local only, common root: `~/.pi/agent/skills/` (93 packs, `references/`, `LICENSE`) — not distributed with the repository | -| Project-specific | `.agents/skills/blender-skills/blender-director/` in this repository | +| Project-specific | `.agents/skills/blender-skills/blender-director/` (gitignored, not committed) | | Installed | 2026-11-06, copied from a local checkout of `.claude/skills/` without edits; flattened to the common root on 2026-11-10 | +| UE skills | `quodsoler/unreal-engine-skills` `f3742d7`, MIT — 31 packs at `.agents/skills/ue-*/` (gitignored), target UE 5.8 C++ | +| C++ skill | `DiamonDinoia/skill-cpp` `f2617fb`, MIT — `cpp` router at `.agents/skills/cpp/` (gitignored) | -These are instructions and reference notes for agents, not code that runs in a build. Four of them assume a **Blender MCP server**; this project drives Blender headlessly through `bpy` (`Tools/*.py`) instead, so MCP is optional and nothing depends on it. +All skill packs — Blender, Unreal and C++ — are agent instructions, not code that runs in a build, and **none are committed**: `/.agents/skills/` is gitignored and the Blender packs live in the common `~/.pi/agent/skills/` root. Four of the Blender packs assume a **Blender MCP server**; this project drives Blender headlessly through `bpy` (`Tools/*.py`) instead, so MCP is optional and nothing depends on it. To update: copy `.claude/skills/` from a newer upstream checkout over the local directory, then record the new version and commit hash in this table. Skills are read on demand, so the harness catalog may need a reload before they appear as first-class entries. diff --git a/MEMORY.md b/MEMORY.md index 340e78b..ee2da53 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -774,3 +774,13 @@ rebuilt body ends up not simulating (`PhysicsType` left at default, not `Simulat `/tmp/gigline/vehicle`; the wired block is therefore never reached. Fix the source path (or move the FBX) before relying on the import to rebuild the physics asset. - Driving (`-drivetest`) is still untested; settling worked only in the transient run. + +## 2026-11-10 — All skills are gitignored now (owner) + +The owner added `/.agents/skills/` to `.gitignore`, so **no skill pack is committed** — +the UE packs (`ue-*/`), the `cpp` router and the project's `blender-director` are all +local-only. This supersedes the earlier "blender-director stays in the repository" wording. +`AGENTS.md` and `Docs/toolchain.md` are reconciled to say "gitignored, not committed" and to +name the UE and C++ sources (`quodsoler/unreal-engine-skills` `f3742d7`, +`DiamonDinoia/skill-cpp` `f2617fb`). The Blender packs remain in the common +`~/.pi/agent/skills/` root, also outside the repo.