@axinom/mosaic-agent-skills 0.0.1 → 0.2.0-rc.1
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 +11 -116
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,121 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @axinom/mosaic-agent-skills
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
development tools for AI agents.
|
|
3
|
+
## About the Package
|
|
5
4
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
This unified package provides two categories of tools:
|
|
9
|
-
|
|
10
|
-
### 1. Skills Management (4 tools)
|
|
11
|
-
|
|
12
|
-
Official Mosaic development workflows with step-by-step guidance:
|
|
13
|
-
|
|
14
|
-
- `list_skills` - List all available skill workflows
|
|
15
|
-
- `get_skill` - Read a complete skill workflow
|
|
16
|
-
- `get_skill_references` - Read reference files mentioned in workflows
|
|
17
|
-
- `execute_skill` - Commit to executing a workflow
|
|
18
|
-
|
|
19
|
-
### 2. GraphQL Schema Tools (5 tools)
|
|
20
|
-
|
|
21
|
-
Schema inspection and code generation utilities:
|
|
22
|
-
|
|
23
|
-
- `search_schema` - Search schema with regex patterns
|
|
24
|
-
- `get_type_definitions` - Get type definitions (type, input, enum, interface,
|
|
25
|
-
union, scalar)
|
|
26
|
-
- `get_query_fields` - Get Query field definitions with args and return types
|
|
27
|
-
- `get_mutation_fields` - Get Mutation field definitions
|
|
28
|
-
- `get_subscription_fields` - Get Subscription field definitions
|
|
29
|
-
|
|
30
|
-
## Installation
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
yarn add @axinom/mosaic-agent-skills
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Usage
|
|
37
|
-
|
|
38
|
-
### As MCP Server (Claude Desktop, etc.)
|
|
39
|
-
|
|
40
|
-
Add to your MCP client configuration:
|
|
41
|
-
|
|
42
|
-
```json
|
|
43
|
-
{
|
|
44
|
-
"mcpServers": {
|
|
45
|
-
"mosaic-agent-skills": {
|
|
46
|
-
"command": "node",
|
|
47
|
-
"args": [
|
|
48
|
-
"/path/to/node_modules/@axinom/mosaic-agent-skills/dist/index.js"
|
|
49
|
-
],
|
|
50
|
-
"env": {
|
|
51
|
-
"SKILLS_PATH": "/optional/custom/skills/path"
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### Configuration
|
|
59
|
-
|
|
60
|
-
- `SKILLS_PATH` - Optional environment variable to override skills directory
|
|
61
|
-
- Default: `./skills` (bundled with package)
|
|
62
|
-
- Custom: Set to absolute path for external skills
|
|
63
|
-
|
|
64
|
-
## Development
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
# Build
|
|
68
|
-
yarn build
|
|
69
|
-
|
|
70
|
-
# Watch mode
|
|
71
|
-
yarn dev
|
|
72
|
-
|
|
73
|
-
# Start server
|
|
74
|
-
yarn start
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Architecture
|
|
78
|
-
|
|
79
|
-
```
|
|
80
|
-
src/
|
|
81
|
-
├── index.ts # MCP server setup & tool registration
|
|
82
|
-
├── logger.ts # Logging utility
|
|
83
|
-
└── tools/
|
|
84
|
-
├── skills/ # Skills management tools
|
|
85
|
-
│ ├── index.ts # Tool registration
|
|
86
|
-
│ ├── tools.ts # Tool handlers
|
|
87
|
-
│ ├── utils.ts # File scanning & parsing
|
|
88
|
-
│ └── types.ts # Type definitions
|
|
89
|
-
└── graphql/ # GraphQL schema tools
|
|
90
|
-
├── index.ts # Tool registration
|
|
91
|
-
├── tools.ts # Tool handlers
|
|
92
|
-
└── utils.ts # Schema inspection & loading
|
|
93
|
-
|
|
94
|
-
skills/ # Bundled skill workflows
|
|
95
|
-
├── _shared/ # Common references & utilities
|
|
96
|
-
└── [skill-name]/ # Individual skill workflows
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
## Skills Workflows
|
|
100
|
-
|
|
101
|
-
Skills are step-by-step workflows that encode Axinom Mosaic development best
|
|
102
|
-
practices. Each skill provides:
|
|
103
|
-
|
|
104
|
-
- Clear goals and prerequisites
|
|
105
|
-
- Detailed implementation steps
|
|
106
|
-
- Reference files and code examples
|
|
107
|
-
- Validation criteria
|
|
108
|
-
|
|
109
|
-
Skills cover various aspects of Mosaic development including UI generation,
|
|
110
|
-
GraphQL operations, code patterns, and architectural conventions. Use
|
|
111
|
-
`list_skills` to discover available workflows.
|
|
112
|
-
|
|
113
|
-
## Security
|
|
114
|
-
|
|
115
|
-
- Path validation prevents directory traversal attacks
|
|
116
|
-
- Schema paths must be absolute
|
|
117
|
-
- Reference paths resolved relative to skill location
|
|
5
|
+
This package is part of the Axinom Mosaic development platform. More information
|
|
6
|
+
can be found at https://portal.axinom.com/mosaic.
|
|
118
7
|
|
|
119
8
|
## License
|
|
120
9
|
|
|
121
|
-
|
|
10
|
+
This package can be licensed under the
|
|
11
|
+
[Axinom Products Licensing Agreement](https://portal.axinom.com/mosaic/contracts/products-licensing-agreement)
|
|
12
|
+
or evaluated under the
|
|
13
|
+
[Axinom Products Evaluation Agreement](https://portal.axinom.com/mosaic/contracts/products-evaluation-agreement).
|
|
14
|
+
No part of Axinom's software may be copied, modified, propagated, or distributed
|
|
15
|
+
except in accordance with the terms contained in the Axinom Products Licensing
|
|
16
|
+
Agreement and Axinom Products Evaluation Agreement.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@axinom/mosaic-agent-skills",
|
|
3
|
-
"version": "0.0.1",
|
|
3
|
+
"version": "0.2.0-rc.1",
|
|
4
4
|
"description": "MCP server bundled with Mosaic development skills and tools for AI agents",
|
|
5
5
|
"bin": "./dist/index.js",
|
|
6
6
|
"files": [
|
|
@@ -36,5 +36,5 @@
|
|
|
36
36
|
"publishConfig": {
|
|
37
37
|
"access": "public"
|
|
38
38
|
},
|
|
39
|
-
"gitHead": "
|
|
39
|
+
"gitHead": "36876de2292506a132f68cb08109eadc61cf9322"
|
|
40
40
|
}
|