@atheory-ai/skillex 0.6.4 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +51 -4
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -1,24 +1,39 @@
1
1
  # Skillex
2
2
 
3
- Skill management for AI agents in Node.js projects.
3
+ Skill management for AI agents in polyglot projects.
4
4
 
5
- Skillex helps agents load the right guidance for the code they are working on without dumping an entire repo's docs into context. It indexes repo skills, package skills, scope rules, and installed package versions, then answers targeted queries in microseconds.
5
+ Skillex helps agents load the right guidance for the code they are working on without dumping an entire repo's docs into context. It indexes repo skills, package skills, packs, scope rules, and installed package versions, then answers targeted queries in microseconds.
6
6
 
7
7
  ## What Skillex does
8
8
 
9
9
  - Resolves the right skills for a file path, package, topic, or tag
10
10
  - Handles monorepos and multiple installed versions of the same package
11
11
  - Separates public consumer skills from private maintainer skills
12
+ - Activates pack-shipped skills from project files, dependencies, and detectors
13
+ - Lets packages and Go modules ship `skillex/pack.yaml` with their code
12
14
  - Exposes the index through both MCP and a CLI fallback
13
15
  - Generates `AGENTS.md` instructions for agents that cannot use MCP directly
14
16
 
15
- ## Install
17
+ ## Recommended install
18
+
19
+ For cross-ecosystem use, install Skillex as a global platform utility. See the
20
+ main project README for the universal installer.
21
+
22
+ ## Node dev dependency
23
+
24
+ Use this npm package when a Node.js project wants Skillex pinned as local dev
25
+ tooling:
16
26
 
17
27
  ```bash
18
28
  npm install --save-dev @atheory-ai/skillex
29
+ # or
30
+ pnpm add -D @atheory-ai/skillex
31
+ # or
32
+ yarn add -D @atheory-ai/skillex
19
33
  ```
20
34
 
21
- The wrapper package installs the correct native binary for your platform through npm `optionalDependencies`.
35
+ The wrapper package installs the correct native binary for your platform through
36
+ npm `optionalDependencies`.
22
37
 
23
38
  ## Quick start
24
39
 
@@ -60,6 +75,38 @@ skillex query --path packages/app-a/** --format content
60
75
  2. Run `skillex refresh` to rebuild `.skillex/index.db`
61
76
  3. Let your agent query only the skills relevant to its current task
62
77
 
78
+ ## Packs
79
+
80
+ Packs are Skillex's ecosystem extension mechanism. A pack bundles skill files
81
+ with activation rules and optional detectors:
82
+
83
+ ```text
84
+ skillex/
85
+ pack.yaml
86
+ usage.md
87
+ ```
88
+
89
+ ```yaml
90
+ name: my-framework
91
+ version: 1.0.0
92
+ detectors:
93
+ my-framework:
94
+ matches:
95
+ - dependency:
96
+ source: npm-package
97
+ name: my-framework
98
+ skills:
99
+ - file: usage.md
100
+ activate-when:
101
+ detector: my-framework
102
+ scope: boundary
103
+ ```
104
+
105
+ Projects can commit packs locally, and libraries can ship packs with their
106
+ package/module source. Go modules are supported through `go.mod`, local
107
+ `replace`, and `vendor` module roots; Skillex does not download dependencies
108
+ during refresh or query.
109
+
63
110
  ## Why this exists
64
111
 
65
112
  Without scoped skill retrieval, agents either get too little context or far too much of it. Skillex moves scope resolution into deterministic indexing so the model receives the small, correct slice of guidance for the current path and dependency boundary.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atheory-ai/skillex",
3
- "version": "0.6.4",
3
+ "version": "0.7.0",
4
4
  "description": "Skill management for AI agents in Node.js projects",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/atheory-ai/skillex#readme",
@@ -29,10 +29,10 @@
29
29
  "monorepo"
30
30
  ],
31
31
  "optionalDependencies": {
32
- "@atheory-ai/skillex-darwin-arm64": "0.6.4",
33
- "@atheory-ai/skillex-darwin-x64": "0.6.4",
34
- "@atheory-ai/skillex-linux-x64": "0.6.4",
35
- "@atheory-ai/skillex-linux-arm64": "0.6.4",
36
- "@atheory-ai/skillex-win32-x64": "0.6.4"
32
+ "@atheory-ai/skillex-darwin-arm64": "0.7.0",
33
+ "@atheory-ai/skillex-darwin-x64": "0.7.0",
34
+ "@atheory-ai/skillex-linux-x64": "0.7.0",
35
+ "@atheory-ai/skillex-linux-arm64": "0.7.0",
36
+ "@atheory-ai/skillex-win32-x64": "0.7.0"
37
37
  }
38
38
  }