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.
This commit is contained in:
zwitschi committed 2026-11-10 17:58:34 +01:00
1 parent b1c01e3af8
commit 2cd3774aad
3 files changed
+16 -4

No files matched your search

+2 -2
View File
@@ -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. 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/<pack>/SKILL.md` (one level down, flat) and it is picked up everywhere; `references/` sits beside them at `~/.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/<pack>/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 ## 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. `.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.
+4 -2
View File
@@ -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 | | Package | blender-skills `1.3.0`, upstream commit `8f778d2`, MIT |
| Source | <https://github.com/arjun988/blender-skills> | | Source | <https://github.com/arjun988/blender-skills> |
| Location | Local only, common root: `~/.pi/agent/skills/` (93 packs, `references/`, `LICENSE`) — not distributed with the repository | | 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 | | 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. 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.
+10
View File
@@ -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 `/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. (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. - 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.