skill-rails 0.2.1 → 0.2.2
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/.agents/plugins/marketplace.json +20 -0
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +24 -0
- package/README.md +10 -1
- package/dist/mcp.js +1 -1
- package/docs/agents.md +28 -6
- package/mcp.json +14 -0
- package/package.json +6 -2
- package/plugin.json +23 -0
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "skill-rails",
|
|
3
|
+
"interface": {
|
|
4
|
+
"displayName": "skill-rails"
|
|
5
|
+
},
|
|
6
|
+
"plugins": [
|
|
7
|
+
{
|
|
8
|
+
"name": "skill-rails",
|
|
9
|
+
"source": {
|
|
10
|
+
"source": "local",
|
|
11
|
+
"path": "./"
|
|
12
|
+
},
|
|
13
|
+
"policy": {
|
|
14
|
+
"installation": "AVAILABLE",
|
|
15
|
+
"authentication": "ON_USE"
|
|
16
|
+
},
|
|
17
|
+
"category": "Productivity"
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "skill-rails",
|
|
3
|
+
"version": "0.2.2",
|
|
4
|
+
"description": "Deterministic, testable YAML flows for AI agent skills, in GitHub Actions syntax.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Juani Galán",
|
|
7
|
+
"url": "https://github.com/juanigalan91"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/juanigalan91/skill-rails#readme",
|
|
10
|
+
"license": "MIT",
|
|
11
|
+
"keywords": [
|
|
12
|
+
"agent",
|
|
13
|
+
"skills",
|
|
14
|
+
"claude-code",
|
|
15
|
+
"workflow",
|
|
16
|
+
"mcp",
|
|
17
|
+
"llm",
|
|
18
|
+
"github-actions",
|
|
19
|
+
"codex"
|
|
20
|
+
],
|
|
21
|
+
"repository": "https://github.com/juanigalan91/skill-rails",
|
|
22
|
+
"skills": "./skills/",
|
|
23
|
+
"mcpServers": "./.mcp.json"
|
|
24
|
+
}
|
package/README.md
CHANGED
|
@@ -180,6 +180,15 @@ As a Claude Code plugin, with the skills and the MCP server:
|
|
|
180
180
|
/plugin install skill-rails@skill-rails
|
|
181
181
|
```
|
|
182
182
|
|
|
183
|
+
As a Codex plugin:
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
codex plugin marketplace add juanigalan91/skill-rails
|
|
187
|
+
codex plugin add skill-rails@skill-rails
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
This installs the three skills and the local MCP configuration. See [Codex setup](docs/agents.md#codex) for local installation and client requirements.
|
|
191
|
+
|
|
183
192
|
As a CLI or a library (Node 20 or later):
|
|
184
193
|
|
|
185
194
|
```bash
|
|
@@ -199,7 +208,7 @@ The MCP server works with any MCP client:
|
|
|
199
208
|
|
|
200
209
|
## Other agents
|
|
201
210
|
|
|
202
|
-
Codex, Cursor, Copilot in VS Code, Gemini CLI, and OpenCode can use the shared skills through the CLI or local MCP server. See [agent setup and compatibility](docs/agents.md) for configuration, current verification status, and a client smoke test.
|
|
211
|
+
Codex, Cursor, Copilot in VS Code, Gemini CLI, and OpenCode can use the shared skills through the CLI or local MCP server. See [agent setup and compatibility](docs/agents.md) for configuration, current verification status, and a client smoke test. Native Codex plugin packaging is included from version 0.2.2.
|
|
203
212
|
|
|
204
213
|
## Use
|
|
205
214
|
|
package/dist/mcp.js
CHANGED
|
@@ -10,7 +10,7 @@ const reply = (result) => ({
|
|
|
10
10
|
});
|
|
11
11
|
const LOOP = 'Act on the status of the result: step → do the step, then call flow_done; invalid → correct the output and call flow_done again; done or failed → tell the user the message.';
|
|
12
12
|
export function createServer({ cwd = process.cwd() } = {}) {
|
|
13
|
-
const server = new McpServer({ name: 'skill-rails', version: '0.2.
|
|
13
|
+
const server = new McpServer({ name: 'skill-rails', version: '0.2.2' });
|
|
14
14
|
server.registerTool('flow_start', {
|
|
15
15
|
description: `Start a skill-rails flow: check the flow file, reset its state, and get the first step to do. ${LOOP}`,
|
|
16
16
|
inputSchema: {
|
package/docs/agents.md
CHANGED
|
@@ -7,7 +7,7 @@ skill-rails uses the same CLI, stdio MCP server, and SKILL.md instructions acros
|
|
|
7
7
|
| Client | Skill discovery location (project) | Integration | Live verification |
|
|
8
8
|
|---|---|---|---|
|
|
9
9
|
| Claude Code | Plugin marketplace | Existing plugin | Not rerun for these changes |
|
|
10
|
-
| Codex CLI / IDE | `.agents/skills/` | CLI or stdio MCP |
|
|
10
|
+
| Codex CLI / IDE | Native plugin or `.agents/skills/` | Plugin, CLI or stdio MCP | Marketplace discovery verified; agent-driven flows pending |
|
|
11
11
|
| Cursor | `.cursor/skills/` | CLI or stdio MCP | Pending |
|
|
12
12
|
| Copilot in VS Code | `.github/skills/` | CLI or stdio MCP | Pending |
|
|
13
13
|
| Gemini CLI | `.gemini/skills/` | CLI or stdio MCP | Pending |
|
|
@@ -17,7 +17,7 @@ This table describes setup targets, not certified client behavior. Copilot cloud
|
|
|
17
17
|
|
|
18
18
|
## Use the current checkout
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
Native Codex plugin packaging is included from `skill-rails@0.2.2`. To try local runner changes, build this checkout:
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
23
|
yarn install --immutable
|
|
@@ -31,13 +31,35 @@ The project directory controls shell execution and state lookup. The flow path i
|
|
|
31
31
|
|
|
32
32
|
### Codex
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
Install the plugin from this checkout:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
codex plugin marketplace add /absolute/path/to/skill-rails
|
|
38
|
+
codex plugin add skill-rails@skill-rails
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Install directly from the GitHub repository:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
codex plugin marketplace add juanigalan91/skill-rails
|
|
45
|
+
codex plugin add skill-rails@skill-rails
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Use a Codex version whose `codex plugin --help` exposes these commands. Restart the client or start a new session after installation. The plugin bundles `run-skill-rails`, `create-skill-rails`, and `migrate-to-skill-rails`, plus the stdio MCP server; no manual skill wrappers or separate MCP registration are needed. In desktop clients, the marketplace can also be browsed through the Plugins UI.
|
|
49
|
+
|
|
50
|
+
Launch Codex in the intended project and check `cwd` in the first flow report. The bundled MCP server uses `npx -y skill-rails@0.2 mcp`, so Node, npm, Bash, and access to the npm registry (or a cached package) are required. The plugin installs instructions and configuration; it does not vendor npm dependencies or install Node.
|
|
51
|
+
|
|
52
|
+
The package has portable `plugin.json` and `mcp.json` files, a `.codex-plugin/plugin.json` compatibility manifest, and a `.agents/plugins/marketplace.json` catalog pointing to the package root. Both formats share the same skills and npm runner as the Claude plugin. This adds local/Git marketplace support, not public-directory publication.
|
|
53
|
+
|
|
54
|
+
Marketplace discovery was verified with Codex CLI `0.169.0-alpha.11.1`. Complete the smoke test below before treating agent-driven workflows as verified.
|
|
55
|
+
|
|
56
|
+
For clients without native plugin installation, use the manual skills setup below and register the checkout's server:
|
|
35
57
|
|
|
36
58
|
```bash
|
|
37
59
|
codex mcp add skill-rails -- node /absolute/path/to/skill-rails/bin/skill-rails.js mcp --cwd /absolute/path/to/project
|
|
38
60
|
```
|
|
39
61
|
|
|
40
|
-
Sources: [local skills](https://learn.chatgpt.com/docs/build-skills), [MCP](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).
|
|
62
|
+
Sources: [plugin packaging](https://developers.openai.com/plugins/build/plugins), [local skills](https://learn.chatgpt.com/docs/build-skills), [MCP](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).
|
|
41
63
|
|
|
42
64
|
### Cursor
|
|
43
65
|
|
|
@@ -110,9 +132,9 @@ Merge into `opencode.json`. This is the v2 configuration shape; consult the matc
|
|
|
110
132
|
|
|
111
133
|
Sources: [skills](https://opencode.ai/docs/skills/), [MCP](https://opencode.ai/docs/mcp-servers).
|
|
112
134
|
|
|
113
|
-
## Install the skills
|
|
135
|
+
## Install the skills manually
|
|
114
136
|
|
|
115
|
-
|
|
137
|
+
Skip this section when using the native plugin. For a manual installation, keep this checkout available. For each entry in `skills/`, create a folder in the client's skill discovery directory from the table above, with a `SKILL.md` wrapper containing the matching name and description and an absolute link to the original instructions. For example, `.agents/skills/run-skill-rails/SKILL.md`:
|
|
116
138
|
|
|
117
139
|
```markdown
|
|
118
140
|
---
|
package/mcp.json
ADDED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "skill-rails",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Deterministic, testable YAML flows for AI agent skills, in GitHub Actions syntax.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -20,7 +20,11 @@
|
|
|
20
20
|
"docs",
|
|
21
21
|
"examples",
|
|
22
22
|
".claude-plugin",
|
|
23
|
-
".mcp.json"
|
|
23
|
+
".mcp.json",
|
|
24
|
+
"plugin.json",
|
|
25
|
+
"mcp.json",
|
|
26
|
+
".codex-plugin",
|
|
27
|
+
".agents/plugins/marketplace.json"
|
|
24
28
|
],
|
|
25
29
|
"engines": {
|
|
26
30
|
"node": ">=20"
|
package/plugin.json
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
|
+
"name": "skill-rails",
|
|
4
|
+
"version": "0.2.2",
|
|
5
|
+
"description": "Deterministic, testable YAML flows for AI agent skills, in GitHub Actions syntax.",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "Juani Galán",
|
|
8
|
+
"url": "https://github.com/juanigalan91"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/juanigalan91/skill-rails#readme",
|
|
11
|
+
"license": "MIT",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"agent",
|
|
14
|
+
"skills",
|
|
15
|
+
"claude-code",
|
|
16
|
+
"workflow",
|
|
17
|
+
"mcp",
|
|
18
|
+
"llm",
|
|
19
|
+
"github-actions",
|
|
20
|
+
"codex"
|
|
21
|
+
],
|
|
22
|
+
"repository": "https://github.com/juanigalan91/skill-rails"
|
|
23
|
+
}
|