@owlmeans/agent-skills 0.1.9 → 0.1.11

package/agent-meta/instructions/agent-memory.instructions.md

@@ -0,0 +1,43 @@
+---
+description: "How project memory works in an OwlMeans app — where to store facts/decisions/gotchas for Copilot (.github/memory/) and Claude Code (.claude/memory/), the MEMORY.md index, and when to read/write memory. Apply when remembering something about the project or deciding where a note belongs."
+applyTo: "**/.github/memory/**, **/.claude/memory/**"
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Project memory
+
+Memory is how durable, project-specific knowledge survives across sessions. Keep it **inside the
+project**, never outside the repository.
+
+| Tool | Memory dir | Index |
+|---|---|---|
+| GitHub Copilot | `.github/memory/` | `.github/memory/MEMORY.md` |
+| Claude Code | `.claude/memory/` | `.claude/memory/MEMORY.md` |
+
+Each memory is one Markdown file holding one fact, decision, or gotcha. The `MEMORY.md` index keeps a
+one-line pointer per file and is loaded every session, so keep it current.
+
+## When to read
+
+- **Start of every session** — read `MEMORY.md`, then open any relevant file.
+- **Before a non-trivial task** — check for and read a memory file on that topic.
+
+## When to write
+
+After a task produces knowledge not obvious from the code or git history: a decision and its
+rationale, a gotcha, or project state/goals. Do not record what the repo or git history already says,
+or what only matters to the current conversation.
+
+## How to write one
+
+1. Create `.github/memory/<topic>.md` (and the Claude copy under `.claude/memory/`) with a short slug
+   and a one-line description.
+2. Write the single fact; for decisions/gotchas add why it matters and how to apply it.
+3. Add a one-line pointer to `MEMORY.md`.
+4. Update an existing file instead of duplicating; delete memories that prove wrong.
+
+## Memory vs skill
+
+A repeatable procedure is a skill (see the `skill-authoring` instruction). Memory is for facts about
+this project.

package/agent-meta/instructions/getting-started.instructions.md

@@ -0,0 +1,62 @@
+---
+description: "How to build a fullstack OwlMeans Common app — the common/api/web three-workspace pattern, server and web context bootstrap, shared entrypoints + elevate(), and a session-scoped in-memory resource via @owlmeans/static-resource. Apply when starting a new OwlMeans project or wiring web↔api."
+applyTo: "**/modules.ts, **/context.ts, **/config.ts, **/render.tsx, **/index.tsx, **/sources/**"
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Building a fullstack OwlMeans Common app
+
+A minimal app is a **bun-workspace monorepo with three packages**:
+
+- `sources/common` — shared **entrypoints** (routes), AJV schemas, types and config. The single
+  source of truth.
+- `sources/api` — `@owlmeans/server-app` backend; handlers attached to the shared entrypoints.
+- `sources/web` — `@owlmeans/web-panel` + shadcn UI; screens attached to the same entrypoints.
+
+Full walkthrough: `docs/getting-started.md`. To generate it: `npm create @owlmeans/app`.
+
+## One contract, two sides
+
+Declare each route once in `common`, then `elevate()` it on both sides:
+
+```ts
+// common/modules.ts
+export const sessionModules = [
+  entrypoint(route(session.list, '/:sid/items', { parent: session.base, method: RouteMethod.GET }),
+    filter(params(SessionParamsSchema))),
+]
+// api/modules.ts   → elevate(sessionModules, session.list, handlers.list)
+// web/modules.ts   → elevate(modules, session.list)  // call-only; screens via handler(Component)
+```
+
+## Config
+
+`common/config.ts` registers both services; `base: 'api'` prefixes API routes with `/api`:
+
+```ts
+const cfg = service({ type: AppType.Frontend, service: APP_WEB, host: 'localhost', port: 3001 })
+service({ type: AppType.Backend, service: APP_API, host: 'localhost', port: 3000, base: 'api' }, cfg)
+```
+
+## Backend + in-memory data
+
+```ts
+const context = makeContext(cfg, true)
+appendStaticResource(context, SESSION_ITEMS)   // @owlmeans/static-resource — no DB
+```
+
+Handlers (`handleRequest`/`handleBody`/`handleParams`) use `ctx.getStaticResource<T>(alias)`.
+`static-resource.list()` accepts no criteria — list all and filter in JS. `main(context, appModules)`
+starts the server. Swap for `@owlmeans/mongo-resource` / `redis-resource` when you need persistence.
+
+## Web (shadcn)
+
+`web-panel`'s `PanelApp` is shadcn/Tailwind v4. The app **provides** `@/lib/utils` and
+`@/components/ui/{alert,button,card,input,label,progress}` at the `@` alias (→ `src`). Render with
+`provide` from `@owlmeans/web-client`: `basicRender(<PanelApp context={context} provide={provide} />)`.
+A parent `BASE` route renders the layout via `handler(Layout)`; `HOME` is its default child. Screens
+call the API with `context.entrypoint(alias).call({ params, body })`.
+
+This shape is auth-free by design; add `@owlmeans/server-auth` + `@owlmeans/client-auth` and
+`guard(...)` when needed.

package/agent-meta/instructions/scaffolding.instructions.md

@@ -0,0 +1,47 @@
+---
+description: "How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags and output, plus the manual alternative. Apply when creating or bootstrapping a fresh OwlMeans app."
+applyTo: "**/package.json, **/README.md"
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Scaffolding a new OwlMeans Common project
+
+Two paths produce the same minimal fullstack project (`common` + `api` + `web`, shadcn UI
+navigation/layout, **no auth**, a **session-scoped in-memory resource**). Reference:
+`docs/getting-started.md`.
+
+## Path 1 — `@owlmeans/create-app`
+
+```sh
+npm create @owlmeans/app@latest my-app   # or: bun create @owlmeans/app my-app
+npx @owlmeans/create-app my-app
+```
+
+By default it copies the template, runs `git init`, installs dependencies, and deploys agent
+guidance via `@owlmeans/agent-skills` (`.claude/skills/` + `.github/instructions/`).
+
+Flags: `--name`, `--pm <bun|npm|yarn>` (default `bun`), `--no-install`, `--no-skills`, `--no-git`,
+`--yes`. Run with `cd my-app && bun run dev` (API :3000, web :3001).
+
+Prefer this over hand-writing boilerplate when the user wants to start a new OwlMeans app.
+
+## Path 2 — manual
+
+Follow Option B in `docs/getting-started.md`: bun workspace → `common` (entrypoints/schemas/config)
+→ `api` (`@owlmeans/server-app` + `appendStaticResource` handlers + `main`) → `web`
+(`@owlmeans/web-panel` + shadcn `@`-provided primitives + layout/nav/screens). Finish with
+`npx @owlmeans/agent-skills`.
+
+## Generated layout
+
+```
+my-app/
+├── package.json            # bun workspaces: sources/*
+├── sources/common/         # consts, types, schemas, config, modules
+├── sources/api/            # context (appendStaticResource), app/session/*, modules, index
+└── sources/web/            # vite + tailwind v4, components/ui/*, layout, nav, screens, render
+```
+
+Session items live in `@owlmeans/static-resource`, namespaced by a client-generated `sid` in
+`localStorage` — no database, no authentication.

package/agent-meta/instructions/shadcn-versions.instructions.md

@@ -1,6 +1,7 @@
 ---
 description: How to update Tailwind CSS, shadcn UI primitives, and related UI lib versions across shadcn-based OwlMeans packages. Distinct from the @owlmeans/* version sync (see versions.instructions.md).
 applyTo: "**/components.json"
+scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/agent-meta/instructions/shadcn-web.instructions.md

@@ -1,6 +1,7 @@
 ---
 description: How to build and maintain shadcn UI + Tailwind v4 web packages in OwlMeans Common. Load when editing components.json, tailwind.config.*, globals.css, or files under components/ui/.
 applyTo: "**/components.json, **/tailwind.config.{ts,js,mjs}, **/globals.css, **/components/ui/**, **/@/lib/utils.ts"
+scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/agent-meta/instructions/skill-authoring.instructions.md

@@ -0,0 +1,60 @@
+---
+description: "How to add agent guidance to an OwlMeans project — author a Claude Code skill (.claude/skills/<name>/SKILL.md) and the matching Copilot instruction (.github/instructions/<name>.instructions.md), keep them in sync, and choose skill vs memory. Apply when capturing knowledge as a skill or instruction."
+applyTo: "**/.claude/skills/**, **/.github/instructions/**"
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Authoring agent guidance (skills + instructions)
+
+OwlMeans projects carry agent guidance in two parallel places so both Claude Code and GitHub
+Copilot can use it:
+
+| Tool | Location | Shape |
+|---|---|---|
+| Claude Code | `.claude/skills/<name>/SKILL.md` | one directory per skill, `SKILL.md` is the entrypoint |
+| GitHub Copilot | `.github/instructions/<name>.instructions.md` | one file per topic |
+
+Author **both** for any guidance you want available to either tool, using the same `<name>` on both
+sides so they read as one topic.
+
+## SKILL.md frontmatter (Claude Code)
+
+```yaml
+---
+name: my-skill                  # the /slash-command (lowercase, hyphens)
+description: What it does and WHEN to use it.  # primary auto-invocation signal
+user-invocable: true            # false = background knowledge only
+allowed-tools: Bash(bun *) Read # optional
+---
+```
+
+The `description` decides when Claude auto-invokes the skill — describe the topic and the trigger.
+
+## Instruction frontmatter (Copilot)
+
+```yaml
+---
+description: "Short summary — apply when …"
+applyTo: "**/*.ts, **/relevant/**"   # globs that auto-attach this instruction
+---
+```
+
+`applyTo` controls when Copilot attaches the instruction. Use the patterns the guidance is about;
+fall back to `**/*.ts, **/*.tsx` if broadly relevant.
+
+## Keep the pair in sync
+
+Change one side, change the other. They need not be identical prose but must not contradict.
+Cross-reference related guidance by name.
+
+## Skill vs memory
+
+- **Skill / instruction** — a reusable procedure or reference worth auto-invoking.
+- **Memory** (`.claude/memory/`, `.github/memory/`) — a fact, decision, or gotcha specific to this
+  project's history. See the `agent-memory` instruction.
+
+## After adding a skill
+
+List it in `.github/memory/MEMORY.md` (and `.claude/memory/MEMORY.md`), and reference it from
+`.github/copilot-instructions.md` / `CLAUDE.md` if it should be discoverable every session.

package/agent-meta/manifest.json

@@ -1,35 +1,91 @@
 {
   "schemaVersion": 1,
   "package": "@owlmeans/agent-skills",
-  "version": "0.1.9",
-  "generatedAt": "2026-06-14T13:34:06.135Z",
+  "version": "0.1.11",
+  "generatedAt": "2026-06-17T10:37:52.346Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
+    {
+      "kind": "skill",
+      "name": "getting-started",
+      "category": "general",
+      "file": "skills/getting-started/SKILL.md",
+      "canonicalPath": ".claude/skills/getting-started/SKILL.md"
+    },
     {
       "kind": "skill",
       "name": "shadcn-web",
-      "category": "multi-package",
+      "category": "general",
       "file": "skills/shadcn-web/SKILL.md",
       "canonicalPath": ".claude/skills/shadcn-web/SKILL.md"
     },
+    {
+      "kind": "skill",
+      "name": "agent-memory",
+      "category": "general",
+      "file": "skills/agent-memory/SKILL.md",
+      "canonicalPath": ".claude/skills/agent-memory/SKILL.md"
+    },
+    {
+      "kind": "skill",
+      "name": "scaffolding",
+      "category": "general",
+      "file": "skills/scaffolding/SKILL.md",
+      "canonicalPath": ".claude/skills/scaffolding/SKILL.md"
+    },
+    {
+      "kind": "skill",
+      "name": "skill-authoring",
+      "category": "general",
+      "file": "skills/skill-authoring/SKILL.md",
+      "canonicalPath": ".claude/skills/skill-authoring/SKILL.md"
+    },
     {
       "kind": "skill",
       "name": "shadcn-versions",
-      "category": "multi-package",
+      "category": "general",
       "file": "skills/shadcn-versions/SKILL.md",
       "canonicalPath": ".claude/skills/shadcn-versions/SKILL.md"
     },
+    {
+      "kind": "instruction",
+      "name": "getting-started",
+      "category": "general",
+      "file": "instructions/getting-started.instructions.md",
+      "canonicalPath": ".github/instructions/getting-started.instructions.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "scaffolding",
+      "category": "general",
+      "file": "instructions/scaffolding.instructions.md",
+      "canonicalPath": ".github/instructions/scaffolding.instructions.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "skill-authoring",
+      "category": "general",
+      "file": "instructions/skill-authoring.instructions.md",
+      "canonicalPath": ".github/instructions/skill-authoring.instructions.md"
+    },
     {
       "kind": "instruction",
       "name": "shadcn-versions",
-      "category": "multi-package",
+      "category": "general",
       "file": "instructions/shadcn-versions.instructions.md",
       "canonicalPath": ".github/instructions/shadcn-versions.instructions.md"
     },
+    {
+      "kind": "instruction",
+      "name": "agent-memory",
+      "category": "general",
+      "file": "instructions/agent-memory.instructions.md",
+      "canonicalPath": ".github/instructions/agent-memory.instructions.md"
+    },
     {
       "kind": "instruction",
       "name": "shadcn-web",
-      "category": "multi-package",
+      "category": "general",
       "file": "instructions/shadcn-web.instructions.md",
       "canonicalPath": ".github/instructions/shadcn-web.instructions.md"
     }

package/agent-meta/skills/agent-memory/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: agent-memory
+description: How project memory works in an OwlMeans app — where to store facts/decisions/gotchas for Claude Code (.claude/memory/) and Copilot (.github/memory/), the MEMORY.md index, and when to read and write memory. Use when asked to remember something about the project, or to decide where a note belongs.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Project memory
+
+Memory is how durable, project-specific knowledge survives across sessions. Keep it **inside the
+project**, never in `~/.claude/` or `~/.copilot/`.
+
+| Tool | Memory dir | Index |
+|---|---|---|
+| Claude Code | `.claude/memory/` | `.claude/memory/MEMORY.md` |
+| GitHub Copilot | `.github/memory/` | `.github/memory/MEMORY.md` |
+
+Each memory is one Markdown file holding one fact, decision, or gotcha. The `MEMORY.md` index has a
+one-line pointer per file (`- [Title](file.md) — hook`) and is loaded every session, so it must stay
+current.
+
+## When to read memory
+
+- **At the start of every session** — read `MEMORY.md`, then open any file relevant to the task.
+- **Before a non-trivial task** — check for a memory file on that topic and read it first.
+- Don't rely on assumptions when a memory file exists; read it.
+
+## When to write memory
+
+After a task produces knowledge that isn't obvious from the code or git history:
+
+- A **decision** and why it was made (and what was rejected).
+- A **gotcha** or sharp edge discovered the hard way.
+- **Project state / goals** not derivable from the repo.
+
+Do **not** record what the code or git history already says, or what only matters to the current
+conversation.
+
+## How to write one
+
+1. Create `.claude/memory/<topic>.md` (and the Copilot copy under `.github/memory/`) with a short
+   slug name and a one-line description.
+2. Write the single fact; for decisions/gotchas, add why it matters and how to apply it.
+3. Add a one-line pointer to the matching `MEMORY.md` index.
+4. Before saving, check for an existing file that already covers it — update that instead of
+   duplicating. Delete memories that turn out to be wrong.
+
+## Memory vs skill
+
+If you are writing a **repeatable procedure** ("to do X, do Y"), that is a skill — see the
+`skill-authoring` skill. Memory is for **facts about this project** ("we chose X because Y").

package/agent-meta/skills/getting-started/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: getting-started
+description: How to build a fullstack OwlMeans Common app from scratch — the common/api/web three-workspace pattern, context bootstrap on server and web, shared entrypoints + elevate(), and a session-scoped in-memory resource with @owlmeans/static-resource. Use when starting a new OwlMeans project, wiring web↔api, or asked how the pieces fit together.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Getting started with OwlMeans Common — fullstack app shape
+
+A minimal OwlMeans app is a **bun-workspace monorepo with three packages**:
+
+```
+sources/
+├── common/   # shared entrypoints (routes), AJV schemas, types, config — the single source of truth
+├── api/      # @owlmeans/server-app backend; handlers attached to the shared entrypoints
+└── web/      # @owlmeans/web-panel + shadcn UI; screens attached to the same entrypoints
+```
+
+The full, runnable walkthrough (scaffolded **and** manual) lives in
+[`docs/getting-started.md`](../../../docs/getting-started.md). To generate this exact project, use
+[[scaffolding]] (`npm create @owlmeans/app`). This skill is the mental model.
+
+## The core idea: one contract, two sides
+
+Declare each route once in `common` as an **entrypoint**, then `elevate()` it on each side:
+
+```ts
+// common/modules.ts — declaration + validation, no implementation
+export const sessionModules = [
+  entrypoint(route(session.base, '/session')),
+  entrypoint(route(session.list, '/:sid/items', { parent: session.base, method: RouteMethod.GET }),
+    filter(params<SessionParams>(SessionParamsSchema))),
+  entrypoint(route(session.add, '/:sid/items', { parent: session.base, method: RouteMethod.POST }),
+    filter(params<SessionParams>(SessionParamsSchema, body<AddItemPayload>(AddItemSchema)))),
+]
+```
+
+```ts
+// api/modules.ts — attach handlers
+elevate(sessionModules, session.list, handlers.list)
+export const appModules = [...modules, ...sessionModules]        // `modules` = framework defaults
+```
+
+```ts
+// web/modules.ts — attach screen components, plus call-only elevation for backend routes
+elevate(modules, session.list)                                    // callable from the client
+modules.push(entrypoint(route(web.session, '/session', frontend({ parent: BASE })), handler(SessionScreen)))
+```
+
+Change a route or schema in `common` and both sides stay in sync. See [[entrypoint]], [[route]],
+[[server-app]], [[web-client]], [[web-panel]].
+
+## Shared config (where services live)
+
+`common/config.ts` registers both services so the web knows where the API is. `base: 'api'`
+prefixes API routes with `/api`:
+
+```ts
+const cfg = service({ type: AppType.Frontend, service: APP_WEB, host: 'localhost', port: 3001 })
+service({ type: AppType.Backend, service: APP_API, host: 'localhost', port: 3000, base: 'api' }, cfg)
+cfg.debug = { all: true }
+export const commonConfig = cfg
+```
+
+api: `config(APP_API, commonConfig)` (+ `cfg.port`). web: `config(APP_WEB, commonConfig)`. See [[config]].
+
+## Backend bootstrap + in-memory data
+
+```ts
+// api/context.ts
+const context = makeContext(cfg, true)          // from @owlmeans/server-app
+appendStaticResource(context, SESSION_ITEMS)    // @owlmeans/static-resource — in-memory, no DB
+```
+
+Handlers use `handleRequest` / `handleBody` / `handleParams` (validated payload, then context, then
+req). Read/write `ctx.getStaticResource<T>(alias)` — full CRUD (`get/load/list/create/save/delete`).
+**`static-resource.list()` takes no criteria** — list all and filter in JS (e.g. by `sessionId`).
+`main(context, appModules)` starts the server. See [[static-resource]], [[server-app]], [[resource]].
+
+Swap `@owlmeans/static-resource` for [[mongo-resource]] / [[redis-resource]] when you need
+persistence — the handler shape is identical.
+
+## Web bootstrap (shadcn)
+
+`@owlmeans/web-panel`'s `PanelApp` is shadcn/Tailwind v4 (no MUI). The **app provides** the shadcn
+primitives at the `@` alias — `web-panel` references `@/lib/utils` and
+`@/components/ui/{alert,button,card,input,label,progress}`; copy those into `src/`. Render with
+`provide` from `@owlmeans/web-client`:
+
+```tsx
+basicRender(<PanelApp context={context} provide={provide} />)
+```
+
+`vite.config.ts` sets `@`→`src`, `@tailwindcss/vite`, and dedupes the owlmeans/react singletons.
+`index.css` is `@import "tailwindcss";` + a shadcn `@theme` token block (replaces `@owlmeans/owl-theme`).
+A parent `BASE` route renders the layout via `handler(LayoutComponent)`; `HOME` is its default child.
+Screens call the backend with `context.entrypoint(alias).call({ params, body })` → `[data, outcome]`.
+See [[web-panel]], [[web-client]], [[shadcn-web]], [[client-entrypoint]].
+
+## Authentication
+
+This shape is intentionally **auth-free**. To add it: `@owlmeans/server-auth` + `@owlmeans/client-auth`
+and `guard(...)` on entrypoints. See [[auth-protocol]], [[server-auth]], [[client-auth]].

package/agent-meta/skills/scaffolding/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: scaffolding
+description: How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags, what it generates, and the manual alternative. Use when asked to create/bootstrap/start a new OwlMeans app or set up a fresh project.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Scaffolding a new OwlMeans Common project
+
+Two paths produce the same minimal fullstack project (`common` + `api` + `web`, shadcn UI
+navigation/layout, **no auth**, a **session-scoped in-memory resource**). The full reference is
+[`docs/getting-started.md`](../../../docs/getting-started.md); the framework shape is [[getting-started]].
+
+## Path 1 — `@owlmeans/create-app` (one command)
+
+```sh
+npm create @owlmeans/app@latest my-app
+bun create @owlmeans/app my-app
+yarn create @owlmeans/app my-app
+npx @owlmeans/create-app my-app
+```
+
+By default it copies the template, runs `git init`, installs dependencies, and **deploys agent
+guidance** into the project via [[bun]]-installed `@owlmeans/agent-skills` (`.claude/skills/` +
+`.github/instructions/`).
+
+Flags: `--name <name>`, `--pm <bun|npm|yarn>` (default `bun`), `--no-install`, `--no-skills`,
+`--no-git`, `--yes`/`-y`, `--help`.
+
+Then run:
+
+```sh
+cd my-app && bun run dev      # API :3000, web :3001
+```
+
+**When an agent should use this:** the user asks to start/bootstrap/create a new OwlMeans app from
+nothing. Prefer it over hand-writing boilerplate. After it runs, point the user at the **Session**
+screen and `docs/getting-started.md`.
+
+## Path 2 — manual
+
+Follow **Option B** in [`docs/getting-started.md`](../../../docs/getting-started.md): create the bun
+workspace, then `common` (shared entrypoints/schemas/config), `api` (`@owlmeans/server-app` +
+`appendStaticResource` handlers + `main`), and `web` (`@owlmeans/web-panel` + shadcn `@`-provided
+primitives + layout/nav/screens). Finish with `npx @owlmeans/agent-skills` to add agent guidance.
+
+## What gets generated
+
+```
+my-app/
+├── package.json            # bun workspaces: sources/*
+├── CLAUDE.md               # agent context: memory + skill directives + project-purpose placeholder
+├── .github/
+│   ├── copilot-instructions.md   # same directives for Copilot
+│   └── memory/MEMORY.md          # starter memory index
+├── .claude/memory/MEMORY.md      # starter memory index
+├── sources/common/         # consts, types, schemas, config, modules (entrypoints)
+├── sources/api/            # context.ts (appendStaticResource), app/session/*, modules.ts, index.ts
+└── sources/web/            # vite + tailwind v4, components/ui/*, layout, nav, screens, render.tsx
+```
+
+The session demo stores items in `@owlmeans/static-resource`, namespaced by a client-generated
+`sid` kept in `localStorage` — no database, no authentication. See [[static-resource]],
+[[server-app]], [[web-panel]].
+
+## Generated agent guidance
+
+`CLAUDE.md` and `.github/copilot-instructions.md` carry the same memory and skill directives as a
+real OwlMeans project, plus a **project-purpose placeholder** (`<!-- OWLMEANS:PROJECT-PURPOSE -->`).
+On the first agent session that block instructs the agent to ask the user what the project is for and
+replace it in both files. The deployed skills include the general management skills
+[[skill-authoring]] and [[agent-memory]] so the project can grow its own guidance. After adding any
+`@owlmeans/*` dependency, re-run `npx @owlmeans/agent-skills` — discovery scans **every**
+`node_modules/@owlmeans` in the workspace (root and nested under `sources/*`), so package-specific
+skills are picked up even though bun nests them.

package/agent-meta/skills/shadcn-versions/SKILL.md

@@ -2,6 +2,7 @@
 name: shadcn-versions
 description: How to update versions of shadcn UI primitives, Tailwind CSS v4, and related UI libs across all shadcn-based OwlMeans web packages. Distinct from the @owlmeans/* package version sync (see [[versions]] skill). Use when bumping tailwind, shadcn components, or utility libs.
 allowed-tools: Bash(grep *), Bash(sed *), Bash(bun install)
+scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/agent-meta/skills/shadcn-web/SKILL.md

@@ -2,6 +2,7 @@
 name: shadcn-web
 description: How to build and maintain shadcn UI + Tailwind v4 web packages in the OwlMeans framework. Auto-invoked when editing components.json, tailwind.config.*, globals.css, or files under components/ui/. Use when creating a new shadcn-based web package or adding shadcn components.
 user-invocable: false
+scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/agent-meta/skills/skill-authoring/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: skill-authoring
+description: How to add agent guidance to an OwlMeans project — author a Claude Code skill (.claude/skills/<name>/SKILL.md) and its matching GitHub Copilot instruction (.github/instructions/<name>.instructions.md), keep the two in sync, choose frontmatter, and decide skill vs memory. Use when asked to capture knowledge as a skill, add a slash command, or document a repeatable procedure.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Authoring agent guidance (skills + instructions)
+
+OwlMeans projects carry agent guidance in two parallel places so both Claude Code and GitHub
+Copilot can use it:
+
+| Tool | Location | Shape |
+|---|---|---|
+| Claude Code | `.claude/skills/<name>/SKILL.md` | one directory per skill, `SKILL.md` is the entrypoint |
+| GitHub Copilot | `.github/instructions/<name>.instructions.md` | one file per topic |
+
+Author **both** for any guidance you want available to either tool. Keep the same `<name>` on both
+sides so they read as one topic.
+
+## SKILL.md (Claude Code)
+
+```
+.claude/skills/<name>/
+├── SKILL.md          # required — frontmatter + body
+├── reference.md      # optional — deeper detail loaded on demand
+└── scripts/          # optional — shell scripts the skill runs
+```
+
+Frontmatter:
+
+```yaml
+---
+name: my-skill                  # the /slash-command (lowercase, hyphens)
+description: What it does and WHEN to use it.  # primary auto-invocation signal
+user-invocable: true            # false = background knowledge only, hidden from the / menu
+allowed-tools: Bash(bun *) Read # optional — tools usable without per-call approval
+---
+```
+
+The `description` is the most important field: Claude uses it to decide when to auto-invoke the
+skill, so describe both the topic and the trigger ("Use when …").
+
+## <name>.instructions.md (Copilot)
+
+```yaml
+---
+description: "Short summary — apply when …"
+applyTo: "**/*.ts, **/relevant/**"   # globs that auto-attach this instruction
+---
+```
+
+`applyTo` controls when Copilot pulls the instruction in. Use the file patterns the guidance is
+actually about; fall back to `**/*.ts, **/*.tsx` if it is broadly relevant.
+
+## Keep the pair in sync
+
+When you change one side, change the other. They do not have to be identical prose, but they must
+not contradict each other. Cross-reference related guidance by name (e.g. "see the `getting-started`
+skill").
+
+## Skill vs memory
+
+- **Skill / instruction** — a reusable procedure or reference you (or the tools) will want again,
+  worth auto-invoking. Lives in `.claude/skills/` + `.github/instructions/`.
+- **Memory** — a fact, decision, or gotcha specific to this project's history/state. Lives in
+  `.claude/memory/` + `.github/memory/`. See the `agent-memory` skill.
+
+If you find yourself writing "last time we…", that is memory. If you are writing "to do X, do Y",
+that is a skill.
+
+## After adding a skill
+
+1. If it replaces an ad-hoc `.claude/<topic>.md`, remove that file.
+2. Mention it in `.claude/memory/MEMORY.md` (and `.github/memory/MEMORY.md`) so future sessions know
+   it exists.
+3. Reference it from `CLAUDE.md` / `.github/copilot-instructions.md` if it should be discoverable
+   every session.

package/build/discover.d.ts

@@ -1,7 +1,7 @@
 export interface ManifestEntry {
     kind: 'skill' | 'instruction';
     name: string;
-    category: 'package-specific' | 'multi-package';
+    category: 'package-specific' | 'multi-package' | 'general';
     file: string;
     canonicalPath: string;
 }
@@ -16,7 +16,7 @@ export interface Manifest {
 export interface DiscoveredEntry {
     kind: 'skill' | 'instruction';
     name: string;
-    category: 'package-specific' | 'multi-package';
+    category: 'package-specific' | 'multi-package' | 'general';
     /** Absolute path to the embedded source file. */
     sourcePath: string;
     canonicalPath: string;

package/build/discover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAAA;IAC9C,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;CACjB;AA4FD,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,mEAAmE;AACnE,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,OAAM,eAAoB,KAAG,eAAe,EA4CvF,CAAA"}
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAA;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAA;IAC1D,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;CACjB;AA+KD,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,mEAAmE;AACnE,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,OAAM,eAAoB,KAAG,eAAe,EA4CvF,CAAA"}

package/build/discover.js

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 /** Parse a manifest.json, return null if invalid/unparseable. */
@@ -14,27 +14,85 @@ const parseManifest = (manifestPath) => {
         return null;
     }
 };
-// Scan node_modules/@owlmeans/*/agent-meta/ for manifests.
-const scanNodeModules = (targetDir) => {
-    const nmDir = join(targetDir, 'node_modules', '@owlmeans');
-    if (!existsSync(nmDir))
-        return [];
-    const entries = [];
+const OWLMEANS_SCOPE = '@owlmeans';
+/**
+ * Collect every existing `<...>/node_modules/@owlmeans` directory in the project
+ * tree. A scaffolded app is a bun workspace whose `@owlmeans/*` deps belong to its
+ * `sources/*` packages (the root has none), so bun may keep them under
+ * `sources/<pkg>/node_modules/@owlmeans` rather than at the root. Scanning only the
+ * root would miss them — so we walk the whole tree.
+ *
+ * The walk is bounded: it never descends into a `node_modules` directory (it just
+ * records its `@owlmeans` scope), skips hidden dirs (`.git`, `.github`, …), and
+ * tracks visited realpaths to avoid symlink cycles.
+ */
+const collectScopeDirs = (targetDir) => {
+    const found = [];
+    const seen = new Set();
+    const walk = (dir) => {
+        let real;
+        try {
+            real = realpathSync(dir);
+        }
+        catch {
+            return;
+        }
+        if (seen.has(real))
+            return;
+        seen.add(real);
+        let dirents;
+        try {
+            dirents = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const dirent of dirents) {
+            const name = dirent.name;
+            if (name === 'node_modules') {
+                const scope = join(dir, 'node_modules', OWLMEANS_SCOPE);
+                if (existsSync(scope))
+                    found.push(scope);
+                // never descend into node_modules
+                continue;
+            }
+            if (name.startsWith('.'))
+                continue;
+            if (!dirent.isDirectory())
+                continue;
+            walk(join(dir, name));
+        }
+    };
+    walk(targetDir);
+    return found;
+};
+/** Read all @owlmeans packages under a single `.../node_modules/@owlmeans` dir. */
+const scanScopeDir = (scopeDir) => {
     let pkgDirs;
     try {
-        pkgDirs = readdirSync(nmDir);
+        pkgDirs = readdirSync(scopeDir);
     }
     catch {
         return [];
     }
+    const packages = [];
     for (const pkgDir of pkgDirs) {
-        const manifestPath = join(nmDir, pkgDir, 'agent-meta', 'manifest.json');
+        const pkgPath = join(scopeDir, pkgDir);
+        const agentMetaDir = join(pkgPath, 'agent-meta');
+        const manifestPath = join(agentMetaDir, 'manifest.json');
         if (!existsSync(manifestPath))
             continue;
         const manifest = parseManifest(manifestPath);
         if (manifest == null)
             continue;
-        const agentMetaDir = join(nmDir, pkgDir, 'agent-meta');
+        let realDir;
+        try {
+            realDir = realpathSync(pkgPath);
+        }
+        catch {
+            realDir = pkgPath;
+        }
+        const entries = [];
         for (const e of manifest.entries) {
             const sourcePath = join(agentMetaDir, e.file);
             if (!existsSync(sourcePath))
@@ -50,6 +108,23 @@ const scanNodeModules = (targetDir) => {
                 isExtra: false,
             });
         }
+        if (entries.length > 0)
+            packages.push({ realDir, entries });
+    }
+    return packages;
+};
+// Scan every node_modules/@owlmeans/*/agent-meta/ in the project tree for manifests.
+const scanNodeModules = (targetDir) => {
+    const entries = [];
+    const seenPkgDirs = new Set();
+    for (const scopeDir of collectScopeDirs(targetDir)) {
+        for (const pkg of scanScopeDir(scopeDir)) {
+            // Skip a package already read via another (symlinked) location.
+            if (seenPkgDirs.has(pkg.realDir))
+                continue;
+            seenPkgDirs.add(pkg.realDir);
+            entries.push(...pkg.entries);
+        }
     }
     return entries;
 };

package/build/discover.js.map

@@ -1 +1 @@
-{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"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"}

package/build/linked.d.ts

@@ -10,6 +10,15 @@ export interface LinkedResult {
  *
  * A package is considered linked when its node_modules/@owlmeans/<pkg>
  * entry is a symlink whose real path escapes the node_modules tree.
+ *
+ * This intentionally scans only the ROOT node_modules, even though discovery
+ * (see discover.ts) now walks the whole tree. Dev-linked monorepos (e.g. a project
+ * that symlinks the common source under libraries/*) hoist @owlmeans/* to the root
+ * node_modules as escaping symlinks, so the root scan catches them. A standalone
+ * scaffolded app has no root @owlmeans scope at all (its deps nest under
+ * sources/*\/node_modules), so this correctly returns { linked: false } and the
+ * install proceeds. Scanning nested node_modules here would risk false positives on
+ * bun's in-tree store symlinks, so we deliberately do not.
  */
 export declare const detectLinked: (targetDir: string) => LinkedResult;
 //# sourceMappingURL=linked.d.ts.map

package/build/linked.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../src/linked.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,YAiChD,CAAA"}
+{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../src/linked.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,YAiChD,CAAA"}

package/build/linked.js

@@ -7,6 +7,15 @@ import { join, resolve } from 'node:path';
  *
  * A package is considered linked when its node_modules/@owlmeans/<pkg>
  * entry is a symlink whose real path escapes the node_modules tree.
+ *
+ * This intentionally scans only the ROOT node_modules, even though discovery
+ * (see discover.ts) now walks the whole tree. Dev-linked monorepos (e.g. a project
+ * that symlinks the common source under libraries/*) hoist @owlmeans/* to the root
+ * node_modules as escaping symlinks, so the root scan catches them. A standalone
+ * scaffolded app has no root @owlmeans scope at all (its deps nest under
+ * sources/*\/node_modules), so this correctly returns { linked: false } and the
+ * install proceeds. Scanning nested node_modules here would risk false positives on
+ * bun's in-tree store symlinks, so we deliberately do not.
  */
 export const detectLinked = (targetDir) => {
     const nmScope = join(targetDir, 'node_modules', '@owlmeans');

package/build/linked.js.map

@@ -1 +1 @@
-{"version":3,"file":"linked.js","sourceRoot":"","sources":["../src/linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAgB,EAAE;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC,CAAA;IAC5D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAEhE,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IACxC,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;IAEtD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YAC/B,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAA;gBACjC,SAAQ;YACV,CAAC;YACD,qEAAqE;YACrE,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;gBACpE,QAAQ,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAA;AAClD,CAAC,CAAA"}
+{"version":3,"file":"linked.js","sourceRoot":"","sources":["../src/linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAgB,EAAE;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC,CAAA;IAC5D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAEhE,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IACxC,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;IAEtD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YAC/B,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAA;gBACjC,SAAQ;YACV,CAAC;YACD,qEAAqE;YACrE,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;gBACpE,QAAQ,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAA;AAClD,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent-skills",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "license": "MIT",
   "type": "module",
   "scripts": {

package/src/discover.ts

@@ -1,11 +1,11 @@
-import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 export interface ManifestEntry {
   kind: 'skill' | 'instruction'
   name: string
-  category: 'package-specific' | 'multi-package'
+  category: 'package-specific' | 'multi-package' | 'general'
   file: string
   canonicalPath: string
 }
@@ -22,7 +22,7 @@ export interface Manifest {
 export interface DiscoveredEntry {
   kind: 'skill' | 'instruction'
   name: string
-  category: 'package-specific' | 'multi-package'
+  category: 'package-specific' | 'multi-package' | 'general'
   /** Absolute path to the embedded source file. */
   sourcePath: string
   canonicalPath: string
@@ -45,26 +45,91 @@ const parseManifest = (manifestPath: string): Manifest | null => {
   }
 }
 
-// Scan node_modules/@owlmeans/*/agent-meta/ for manifests.
-const scanNodeModules = (targetDir: string): DiscoveredEntry[] => {
-  const nmDir = join(targetDir, 'node_modules', '@owlmeans')
-  if (!existsSync(nmDir)) return []
+const OWLMEANS_SCOPE = '@owlmeans'
 
-  const entries: DiscoveredEntry[] = []
+/**
+ * Collect every existing `<...>/node_modules/@owlmeans` directory in the project
+ * tree. A scaffolded app is a bun workspace whose `@owlmeans/*` deps belong to its
+ * `sources/*` packages (the root has none), so bun may keep them under
+ * `sources/<pkg>/node_modules/@owlmeans` rather than at the root. Scanning only the
+ * root would miss them — so we walk the whole tree.
+ *
+ * The walk is bounded: it never descends into a `node_modules` directory (it just
+ * records its `@owlmeans` scope), skips hidden dirs (`.git`, `.github`, …), and
+ * tracks visited realpaths to avoid symlink cycles.
+ */
+const collectScopeDirs = (targetDir: string): string[] => {
+  const found: string[] = []
+  const seen = new Set<string>()
+
+  const walk = (dir: string): void => {
+    let real: string
+    try {
+      real = realpathSync(dir)
+    } catch {
+      return
+    }
+    if (seen.has(real)) return
+    seen.add(real)
+
+    let dirents: import('node:fs').Dirent[]
+    try {
+      dirents = readdirSync(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+
+    for (const dirent of dirents) {
+      const name = dirent.name
+      if (name === 'node_modules') {
+        const scope = join(dir, 'node_modules', OWLMEANS_SCOPE)
+        if (existsSync(scope)) found.push(scope)
+        // never descend into node_modules
+        continue
+      }
+      if (name.startsWith('.')) continue
+      if (!dirent.isDirectory()) continue
+      walk(join(dir, name))
+    }
+  }
+
+  walk(targetDir)
+  return found
+}
+
+interface ScopePackage {
+  /** Realpath of the package dir, used to dedup the same physical package read via
+   *  multiple (symlinked) locations. */
+  realDir: string
+  entries: DiscoveredEntry[]
+}
+
+/** Read all @owlmeans packages under a single `.../node_modules/@owlmeans` dir. */
+const scanScopeDir = (scopeDir: string): ScopePackage[] => {
   let pkgDirs: string[]
   try {
-    pkgDirs = readdirSync(nmDir)
+    pkgDirs = readdirSync(scopeDir)
   } catch {
     return []
   }
 
+  const packages: ScopePackage[] = []
   for (const pkgDir of pkgDirs) {
-    const manifestPath = join(nmDir, pkgDir, 'agent-meta', 'manifest.json')
+    const pkgPath = join(scopeDir, pkgDir)
+    const agentMetaDir = join(pkgPath, 'agent-meta')
+    const manifestPath = join(agentMetaDir, 'manifest.json')
     if (!existsSync(manifestPath)) continue
     const manifest = parseManifest(manifestPath)
     if (manifest == null) continue
 
-    const agentMetaDir = join(nmDir, pkgDir, 'agent-meta')
+    let realDir: string
+    try {
+      realDir = realpathSync(pkgPath)
+    } catch {
+      realDir = pkgPath
+    }
+
+    const entries: DiscoveredEntry[] = []
     for (const e of manifest.entries) {
       const sourcePath = join(agentMetaDir, e.file)
       if (!existsSync(sourcePath)) continue
@@ -79,6 +144,24 @@ const scanNodeModules = (targetDir: string): DiscoveredEntry[] => {
         isExtra: false,
       })
     }
+    if (entries.length > 0) packages.push({ realDir, entries })
+  }
+
+  return packages
+}
+
+// Scan every node_modules/@owlmeans/*/agent-meta/ in the project tree for manifests.
+const scanNodeModules = (targetDir: string): DiscoveredEntry[] => {
+  const entries: DiscoveredEntry[] = []
+  const seenPkgDirs = new Set<string>()
+
+  for (const scopeDir of collectScopeDirs(targetDir)) {
+    for (const pkg of scanScopeDir(scopeDir)) {
+      // Skip a package already read via another (symlinked) location.
+      if (seenPkgDirs.has(pkg.realDir)) continue
+      seenPkgDirs.add(pkg.realDir)
+      entries.push(...pkg.entries)
+    }
   }
 
   return entries

package/src/linked.ts

@@ -14,6 +14,15 @@ export interface LinkedResult {
  *
  * A package is considered linked when its node_modules/@owlmeans/<pkg>
  * entry is a symlink whose real path escapes the node_modules tree.
+ *
+ * This intentionally scans only the ROOT node_modules, even though discovery
+ * (see discover.ts) now walks the whole tree. Dev-linked monorepos (e.g. a project
+ * that symlinks the common source under libraries/*) hoist @owlmeans/* to the root
+ * node_modules as escaping symlinks, so the root scan catches them. A standalone
+ * scaffolded app has no root @owlmeans scope at all (its deps nest under
+ * sources/*\/node_modules), so this correctly returns { linked: false } and the
+ * install proceeds. Scanning nested node_modules here would risk false positives on
+ * bun's in-tree store symlinks, so we deliberately do not.
  */
 export const detectLinked = (targetDir: string): LinkedResult => {
   const nmScope = join(targetDir, 'node_modules', '@owlmeans')

package/tests/installer.test.ts

@@ -142,6 +142,57 @@ describe('discover()', () => {
     const entries = discover(tmpDir, { extras: false, copilotOnly: true })
     expect(entries.every(e => e.kind === 'instruction')).toBe(true)
   })
+
+  it('discovers entries nested in workspace package node_modules (bun monorepo)', () => {
+    // Scaffolded bun workspace: root has no @owlmeans; deps live under sources/*.
+    writeFixturePackage(join(tmpDir, 'sources', 'web', 'node_modules'), '@owlmeans/web-panel', '0.1.9', [
+      { kind: 'skill', name: 'web-panel' },
+      { kind: 'instruction', name: 'web-panel' },
+    ])
+    writeFixturePackage(join(tmpDir, 'sources', 'api', 'node_modules'), '@owlmeans/server-app', '0.1.9', [
+      { kind: 'skill', name: 'server-app' },
+    ])
+    const entries = discover(tmpDir, { extras: false })
+    expect(entries.some(e => e.kind === 'skill' && e.name === 'web-panel')).toBe(true)
+    expect(entries.some(e => e.kind === 'instruction' && e.name === 'web-panel')).toBe(true)
+    expect(entries.some(e => e.kind === 'skill' && e.name === 'server-app')).toBe(true)
+  })
+
+  it('combines root and nested node_modules', () => {
+    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.9', [
+      { kind: 'skill', name: 'context' },
+    ])
+    writeFixturePackage(join(tmpDir, 'sources', 'web', 'node_modules'), '@owlmeans/web-panel', '0.1.9', [
+      { kind: 'skill', name: 'web-panel' },
+    ])
+    const entries = discover(tmpDir, { extras: false })
+    expect(entries.some(e => e.name === 'context')).toBe(true)
+    expect(entries.some(e => e.name === 'web-panel')).toBe(true)
+  })
+
+  it('does not double-count a package symlinked into multiple workspaces', () => {
+    // Physical package under the root store…
+    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.9', [
+      { kind: 'skill', name: 'context' },
+    ])
+    const realPkg = join(tmpDir, 'node_modules', '@owlmeans', 'context')
+    // …symlinked into a workspace's node_modules (as bun's store linker may do).
+    const nestedScope = join(tmpDir, 'sources', 'web', 'node_modules', '@owlmeans')
+    mkdirSync(nestedScope, { recursive: true })
+    symlinkSync(realPkg, join(nestedScope, 'context'))
+
+    const entries = discover(tmpDir, { extras: false })
+    expect(entries.filter(e => e.name === 'context')).toHaveLength(1)
+  })
+
+  it('ignores hidden directories while walking', () => {
+    // A stray manifest under a hidden dir must not be picked up.
+    writeFixturePackage(join(tmpDir, '.git', 'node_modules'), '@owlmeans/ghost', '0.1.9', [
+      { kind: 'skill', name: 'ghost' },
+    ])
+    const entries = discover(tmpDir, { extras: false })
+    expect(entries.some(e => e.name === 'ghost')).toBe(false)
+  })
 })
 
 // ---------------------------------------------------------------------------