@atheory-ai/skillex 0.6.4 → 0.7.1
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.
- package/README.md +51 -4
- 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
|
|
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
|
-
##
|
|
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
|
|
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.
|
|
3
|
+
"version": "0.7.1",
|
|
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.
|
|
33
|
-
"@atheory-ai/skillex-darwin-x64": "0.
|
|
34
|
-
"@atheory-ai/skillex-linux-x64": "0.
|
|
35
|
-
"@atheory-ai/skillex-linux-arm64": "0.
|
|
36
|
-
"@atheory-ai/skillex-win32-x64": "0.
|
|
32
|
+
"@atheory-ai/skillex-darwin-arm64": "0.7.1",
|
|
33
|
+
"@atheory-ai/skillex-darwin-x64": "0.7.1",
|
|
34
|
+
"@atheory-ai/skillex-linux-x64": "0.7.1",
|
|
35
|
+
"@atheory-ai/skillex-linux-arm64": "0.7.1",
|
|
36
|
+
"@atheory-ai/skillex-win32-x64": "0.7.1"
|
|
37
37
|
}
|
|
38
38
|
}
|