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.
@@ -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
+ }
@@ -10,7 +10,7 @@
10
10
  "name": "skill-rails",
11
11
  "source": "./",
12
12
  "description": "Deterministic YAML flows for agent skills: run, create and migrate skills to skill-rails",
13
- "version": "0.2.1"
13
+ "version": "0.2.2"
14
14
  }
15
15
  ]
16
16
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "skill-rails",
3
3
  "description": "Deterministic YAML flows for agent skills: run, create and migrate skills to skill-rails",
4
- "version": "0.2.1",
4
+ "version": "0.2.2",
5
5
  "license": "MIT",
6
6
  "keywords": [
7
7
  "skills",
@@ -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. The new compatibility features require this checkout until released.
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.1' });
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 | Pending |
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
- These changes must be released before published `npx` commands include them. To try them now, build this checkout:
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
- Register the checkout's server:
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
- 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`:
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
@@ -0,0 +1,14 @@
1
+ {
2
+ "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
3
+ "mcpServers": {
4
+ "skill-rails": {
5
+ "type": "stdio",
6
+ "command": "npx",
7
+ "args": [
8
+ "-y",
9
+ "skill-rails@0.2",
10
+ "mcp"
11
+ ]
12
+ }
13
+ }
14
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skill-rails",
3
- "version": "0.2.1",
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
+ }