@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.
Files changed (2) hide show
  1. package/README.md +24 -4
  2. 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
- Return full skill content for an agent:
81
+ Use a selected result to read only the guidance needed:
67
82
 
68
83
  ```bash
69
- skillex query --path packages/app-a/** --format content
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` to rebuild `.skillex/index.db`
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.8.2",
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.8.2",
33
- "@atheory-ai/skillex-darwin-x64": "0.8.2",
34
- "@atheory-ai/skillex-linux-x64": "0.8.2",
35
- "@atheory-ai/skillex-linux-arm64": "0.8.2",
36
- "@atheory-ai/skillex-win32-x64": "0.8.2"
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
  }