@atheory-ai/skillex 0.8.2 → 0.9.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.
- package/README.md +24 -4
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -12,6 +12,8 @@ Skillex helps agents load the right guidance for the code they are working on wi
|
|
|
12
12
|
- Activates pack-shipped skills from project files, dependencies, and detectors
|
|
13
13
|
- Lets packages and Go modules ship `skillex/pack.yaml` with their code
|
|
14
14
|
- Exposes the index through both MCP and a CLI fallback
|
|
15
|
+
- Can experimentally discover and invoke trusted downstream MCP capabilities
|
|
16
|
+
without registering them individually with the host
|
|
15
17
|
- Generates `AGENTS.md` instructions for agents that cannot use MCP directly
|
|
16
18
|
|
|
17
19
|
## Recommended install
|
|
@@ -35,6 +37,19 @@ yarn add -D @atheory-ai/skillex
|
|
|
35
37
|
The wrapper package installs the correct native binary for your platform through
|
|
36
38
|
npm `optionalDependencies`.
|
|
37
39
|
|
|
40
|
+
## Experimental downstream MCP broker
|
|
41
|
+
|
|
42
|
+
Skillex 0.9.0 includes an explicitly opt-in downstream MCP capability broker.
|
|
43
|
+
The host registers only Skillex; enabled projects can discover contextual MCP
|
|
44
|
+
capabilities and have Skillex invoke the selected trusted server lazily. Existing
|
|
45
|
+
skills-only projects are unchanged.
|
|
46
|
+
|
|
47
|
+
This broker and its authentication integrations are experimental. The protocol
|
|
48
|
+
flows have automated conformance coverage, but interoperability is not certified
|
|
49
|
+
for every MCP server, identity provider, or enterprise deployment. See the
|
|
50
|
+
[main project documentation](https://github.com/atheory-ai/skillex#downstream-mcp-capability-broker)
|
|
51
|
+
for configuration, security boundaries, and the current support matrix.
|
|
52
|
+
|
|
38
53
|
## Quick start
|
|
39
54
|
|
|
40
55
|
Initialize Skillex in your repository:
|
|
@@ -63,17 +78,22 @@ skillex query --tags migration,breaking-change
|
|
|
63
78
|
skillex query --package @acme/foo
|
|
64
79
|
```
|
|
65
80
|
|
|
66
|
-
|
|
81
|
+
Use a selected result to read only the guidance needed:
|
|
67
82
|
|
|
68
83
|
```bash
|
|
69
|
-
skillex query --path packages/app-a
|
|
84
|
+
skillex query --path packages/app-a/src/auth.ts --search "session handling"
|
|
85
|
+
skillex read --ref <ref-from-query> --section <optional-section-id>
|
|
70
86
|
```
|
|
71
87
|
|
|
88
|
+
`query` returns bounded discovery summaries. Narrow broad results before reading a
|
|
89
|
+
selected skill or section. `--format content` is retained for backward compatibility,
|
|
90
|
+
but is not the recommended agent workflow.
|
|
91
|
+
|
|
72
92
|
## Example workflow
|
|
73
93
|
|
|
74
94
|
1. Add repo skills in `skills/` and configure scopes in `skillex.json`
|
|
75
|
-
2. Run `skillex refresh`
|
|
76
|
-
3. Let your agent query only the skills relevant to its current task
|
|
95
|
+
2. Run `skillex refresh` after changing skills, configuration, or installed dependencies
|
|
96
|
+
3. Let your agent query, narrow, and read only the skills relevant to its current task
|
|
77
97
|
|
|
78
98
|
## Packs
|
|
79
99
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atheory-ai/skillex",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.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.
|
|
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.9.0",
|
|
33
|
+
"@atheory-ai/skillex-darwin-x64": "0.9.0",
|
|
34
|
+
"@atheory-ai/skillex-linux-x64": "0.9.0",
|
|
35
|
+
"@atheory-ai/skillex-linux-arm64": "0.9.0",
|
|
36
|
+
"@atheory-ai/skillex-win32-x64": "0.9.0"
|
|
37
37
|
}
|
|
38
38
|
}
|