@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.
Files changed (2) hide show
  1. package/README.md +70 -0
  2. 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.0",
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.0",
21
- "@atheory-ai/skillex-darwin-x64": "0.6.0",
22
- "@atheory-ai/skillex-linux-x64": "0.6.0",
23
- "@atheory-ai/skillex-linux-arm64": "0.6.0",
24
- "@atheory-ai/skillex-win32-x64": "0.6.0"
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
  }