@atheory-ai/skillex 0.6.0 → 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 +117 -0
  2. package/package.json +18 -6
package/README.md ADDED
@@ -0,0 +1,117 @@
1
+ # Skillex
2
+
3
+ Skill management for AI agents in polyglot 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, packs, 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
+ - Activates pack-shipped skills from project files, dependencies, and detectors
13
+ - Lets packages and Go modules ship `skillex/pack.yaml` with their code
14
+ - Exposes the index through both MCP and a CLI fallback
15
+ - Generates `AGENTS.md` instructions for agents that cannot use MCP directly
16
+
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:
26
+
27
+ ```bash
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
33
+ ```
34
+
35
+ The wrapper package installs the correct native binary for your platform through
36
+ npm `optionalDependencies`.
37
+
38
+ ## Quick start
39
+
40
+ Initialize Skillex in your repository:
41
+
42
+ ```bash
43
+ skillex init
44
+ ```
45
+
46
+ Rebuild the local skill index:
47
+
48
+ ```bash
49
+ skillex refresh
50
+ ```
51
+
52
+ Query the skills that apply to a file:
53
+
54
+ ```bash
55
+ skillex query --path packages/app-a/src/auth.ts
56
+ ```
57
+
58
+ Query by topic, tag, or package:
59
+
60
+ ```bash
61
+ skillex query --topic auth
62
+ skillex query --tags migration,breaking-change
63
+ skillex query --package @acme/foo
64
+ ```
65
+
66
+ Return full skill content for an agent:
67
+
68
+ ```bash
69
+ skillex query --path packages/app-a/** --format content
70
+ ```
71
+
72
+ ## Example workflow
73
+
74
+ 1. Add repo skills in `skills/` and configure scopes in `skillex.json`
75
+ 2. Run `skillex refresh` to rebuild `.skillex/index.db`
76
+ 3. Let your agent query only the skills relevant to its current task
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
+
110
+ ## Why this exists
111
+
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.
113
+
114
+ ## Repository
115
+
116
+ - Source: https://github.com/atheory-ai/skillex
117
+ - 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.7.0",
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.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"
25
37
  }
26
38
  }