@owlmeans/agent-skills 0.1.10 → 0.1.12

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/reuse-code.instructions.md

@@ -0,0 +1,50 @@
+---
+description: "Discovery-first, reuse-first workflow for OwlMeans projects. Apply before planning or building any feature, before proposing a third-party library or custom solution, and after writing code: find an existing @owlmeans/* package or existing code first, extend before writing new, and simplify what you write."
+applyTo: "**/*.ts, **/*.tsx, **/package.json"
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Reuse before you build
+
+OwlMeans ships a large framework of `@owlmeans/*` packages. Before proposing a third-party library,
+designing a custom solution, or finishing a feature, exhaust what already exists. Apply these four
+steps in order — during planning **and** implementation.
+
+## 1. Find an `@owlmeans/*` package first
+
+- **Consult the deployed instructions.** Each installed `@owlmeans/*` package ships
+  `.github/instructions/<pkg>.instructions.md` (and `.claude/skills/<pkg>/SKILL.md`) describing what it
+  does — your local catalogue of installed capabilities.
+- **Scan installed packages** in `node_modules/@owlmeans/*` and, in a workspace, the nested
+  `sources/*/node_modules/@owlmeans/*`.
+- **Discover not-yet-installed packages** by researching the **owlmeans/common** repository — its
+  `tree.md` dependency map and per-package READMEs.
+
+### Local vs. web research (the symlink rule)
+
+- `ls -la node_modules/@owlmeans/<pkg>`: a **symlink escaping `node_modules`** — or a project whose own
+  workspace publishes `@owlmeans/*` packages (**this is the common repo**) — means the source is local.
+  **Research locally** (`tree.md`, the package sources, the canonical instructions); do **not** use the
+  internet.
+- Otherwise (clean npm install), **research the web**: https://github.com/owlmeans/common.
+
+After adding an `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to deploy its instruction.
+Prefer an `@owlmeans/*` package over a third-party library or bespoke code.
+
+## 2. Reuse or extend before writing custom
+
+If an installed package nearly fits, configure or extend it (its resources, services, modules, helpers)
+rather than writing a parallel implementation.
+
+## 3. No package? Reuse code and extract an abstraction
+
+Search the codebase for code solving a **similar** problem. Factor out a shared helper or abstraction
+instead of duplicating or starting from scratch. Write new code only when nothing reusable exists.
+
+## 4. Simplify after writing
+
+Review new code: can it be shorter, clearer, fewer moving parts? Lean on framework utilities, drop dead
+branches. Less code that reuses the framework beats more bespoke code.
+
+See the `dependency-tree`, `scaffolding`, and `bun` instructions.

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,8 +1,8 @@
 {
   "schemaVersion": 1,
   "package": "@owlmeans/agent-skills",
-  "version": "0.1.10",
-  "generatedAt": "2026-06-17T09:37:28.174Z",
+  "version": "0.1.12",
+  "generatedAt": "2026-06-17T14:51:24.131Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {
@@ -19,6 +19,20 @@
       "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": "reuse-code",
+      "category": "general",
+      "file": "skills/reuse-code/SKILL.md",
+      "canonicalPath": ".claude/skills/reuse-code/SKILL.md"
+    },
     {
       "kind": "skill",
       "name": "scaffolding",
@@ -26,6 +40,13 @@
       "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",
@@ -33,6 +54,13 @@
       "file": "skills/shadcn-versions/SKILL.md",
       "canonicalPath": ".claude/skills/shadcn-versions/SKILL.md"
     },
+    {
+      "kind": "instruction",
+      "name": "reuse-code",
+      "category": "general",
+      "file": "instructions/reuse-code.instructions.md",
+      "canonicalPath": ".github/instructions/reuse-code.instructions.md"
+    },
     {
       "kind": "instruction",
       "name": "getting-started",
@@ -47,6 +75,13 @@
       "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",
@@ -54,6 +89,13 @@
       "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",

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/reuse-code/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: reuse-code
+description: Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Reuse before you build
+
+OwlMeans ships a large framework of `@owlmeans/*` packages. Before you propose a third-party library,
+design a custom solution, or finish a feature, exhaust what already exists. Apply these four steps in
+order — during planning **and** during implementation.
+
+## 1. Find an `@owlmeans/*` package first
+
+Before suggesting any external library or writing custom code, look for an `@owlmeans/*` package that
+already solves the problem.
+
+- **Consult the deployed skills.** Each installed `@owlmeans/*` package ships a skill at
+  `.claude/skills/<pkg>/SKILL.md` (and `.github/instructions/<pkg>.instructions.md`) describing what it
+  does. Read those first — they are your local catalogue of installed capabilities.
+- **Scan installed packages.** Look in `node_modules/@owlmeans/*` **and**, in a workspace monorepo,
+  the nested `sources/*/node_modules/@owlmeans/*` (bun nests workspace deps).
+- **Discover packages that aren't installed yet** by researching the **owlmeans/common** repository —
+  its dependency map (`tree.md`) and the per-package READMEs name every package and its purpose.
+
+### Local vs. web research (the symlink rule)
+
+How you research the repo depends on whether `@owlmeans/*` is linked locally:
+
+- Run `ls -la node_modules/@owlmeans/<pkg>` (try a package you know is installed). If it is a **symlink
+  whose target escapes `node_modules`** — or if the project's *own* workspace publishes `@owlmeans/*`
+  packages (i.e. **this is the common repo**) — you have the source locally. **Research locally:** read
+  `tree.md`, browse the framework's package sources, and read the canonical `.claude/skills/`. **Do
+  not** use the internet.
+- Otherwise (a clean install from npm), **research the web**: fetch/search
+  **https://github.com/owlmeans/common** — `tree.md` and package READMEs — to find the right package.
+
+This is the same dev-linked detection `@owlmeans/agent-skills` uses (see its `detectLinked`). After
+adding an `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to deploy its skill. Prefer an
+`@owlmeans/*` package over a third-party library or bespoke code whenever one fits.
+
+## 2. Reuse or extend before writing custom
+
+If an installed package nearly fits, **configure or extend it** rather than writing something new — use
+its resources, services, modules, and helpers. A small extension of a framework package beats a new
+parallel implementation.
+
+## 3. No package? Reuse code and extract an abstraction
+
+When no package solves it, search the codebase for code that already solves a **similar** problem.
+Prefer factoring out a shared helper, base, or generic function — extract an abstraction — over
+duplicating logic or writing from scratch. Only write genuinely new code when nothing reusable exists.
+
+## 4. Simplify after writing
+
+Once code is written, review it: can it be **shorter, clearer, or expressed with fewer moving parts**?
+Lean on framework utilities, remove dead branches, collapse needless indirection. Less code that reuses
+the framework is better than more bespoke code.
+
+See `[[dependency-tree]]` for the package map, `[[scaffolding]]` for how a project is assembled, and
+`[[bun]]` for adding dependencies.

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

@@ -50,6 +50,11 @@ primitives + layout/nav/screens). Finish with `npx @owlmeans/agent-skills` to ad
 ```
 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
@@ -58,3 +63,16 @@ my-app/
 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]], [[agent-memory]] and the mandatory [[reuse-code]] (find an existing `@owlmeans/*`
+package or code before proposing third-party libraries or custom solutions) so the project can grow its own guidance.
+`CLAUDE.md` and `.github/copilot-instructions.md` reference [[reuse-code]] as mandatory. 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/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.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,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;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.10",
+  "version": "0.1.12",
   "license": "MIT",
   "type": "module",
   "scripts": {

package/src/discover.ts

@@ -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'
 
@@ -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)
+  })
 })
 
 // ---------------------------------------------------------------------------