@atheory-ai/skillex 0.6.0 → 0.6.4
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 +70 -0
- package/package.json +18 -6
package/README.md
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Skillex
|
|
2
|
+
|
|
3
|
+
Skill management for AI agents in Node.js projects.
|
|
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.
|
|
6
|
+
|
|
7
|
+
## What Skillex does
|
|
8
|
+
|
|
9
|
+
- Resolves the right skills for a file path, package, topic, or tag
|
|
10
|
+
- Handles monorepos and multiple installed versions of the same package
|
|
11
|
+
- Separates public consumer skills from private maintainer skills
|
|
12
|
+
- Exposes the index through both MCP and a CLI fallback
|
|
13
|
+
- Generates `AGENTS.md` instructions for agents that cannot use MCP directly
|
|
14
|
+
|
|
15
|
+
## Install
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npm install --save-dev @atheory-ai/skillex
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The wrapper package installs the correct native binary for your platform through npm `optionalDependencies`.
|
|
22
|
+
|
|
23
|
+
## Quick start
|
|
24
|
+
|
|
25
|
+
Initialize Skillex in your repository:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
skillex init
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Rebuild the local skill index:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
skillex refresh
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Query the skills that apply to a file:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
skillex query --path packages/app-a/src/auth.ts
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Query by topic, tag, or package:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
skillex query --topic auth
|
|
47
|
+
skillex query --tags migration,breaking-change
|
|
48
|
+
skillex query --package @acme/foo
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Return full skill content for an agent:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
skillex query --path packages/app-a/** --format content
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Example workflow
|
|
58
|
+
|
|
59
|
+
1. Add repo skills in `skills/` and configure scopes in `skillex.json`
|
|
60
|
+
2. Run `skillex refresh` to rebuild `.skillex/index.db`
|
|
61
|
+
3. Let your agent query only the skills relevant to its current task
|
|
62
|
+
|
|
63
|
+
## Why this exists
|
|
64
|
+
|
|
65
|
+
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.
|
|
66
|
+
|
|
67
|
+
## Repository
|
|
68
|
+
|
|
69
|
+
- Source: https://github.com/atheory-ai/skillex
|
|
70
|
+
- Documentation: https://github.com/atheory-ai/skillex/blob/main/README.md
|
package/package.json
CHANGED
|
@@ -1,8 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atheory-ai/skillex",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.4",
|
|
4
4
|
"description": "Skill management for AI agents in Node.js projects",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
|
+
"homepage": "https://github.com/atheory-ai/skillex#readme",
|
|
7
|
+
"bugs": {
|
|
8
|
+
"url": "https://github.com/atheory-ai/skillex/issues"
|
|
9
|
+
},
|
|
6
10
|
"repository": {
|
|
7
11
|
"type": "git",
|
|
8
12
|
"url": "https://github.com/atheory-ai/skillex"
|
|
@@ -16,11 +20,19 @@
|
|
|
16
20
|
"engines": {
|
|
17
21
|
"node": ">=18"
|
|
18
22
|
},
|
|
23
|
+
"keywords": [
|
|
24
|
+
"ai",
|
|
25
|
+
"agent",
|
|
26
|
+
"skills",
|
|
27
|
+
"mcp",
|
|
28
|
+
"cli",
|
|
29
|
+
"monorepo"
|
|
30
|
+
],
|
|
19
31
|
"optionalDependencies": {
|
|
20
|
-
"@atheory-ai/skillex-darwin-arm64": "0.6.
|
|
21
|
-
"@atheory-ai/skillex-darwin-x64": "0.6.
|
|
22
|
-
"@atheory-ai/skillex-linux-x64": "0.6.
|
|
23
|
-
"@atheory-ai/skillex-linux-arm64": "0.6.
|
|
24
|
-
"@atheory-ai/skillex-win32-x64": "0.6.
|
|
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"
|
|
25
37
|
}
|
|
26
38
|
}
|