skill-rails 0.2.0 → 0.2.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.
@@ -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.0"
13
+ "version": "0.2.1"
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.0",
4
+ "version": "0.2.1",
5
5
  "license": "MIT",
6
6
  "keywords": [
7
7
  "skills",
package/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
  [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
9
9
  [![node](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](package.json)
10
10
 
11
- **2× faster · up to 40% cheaper · the same result, every run**
11
+ **Enforced step order · validated outputs · fewer mechanical model turns**
12
12
 
13
13
  </div>
14
14
 
@@ -21,20 +21,27 @@ Then the model skips step 7, runs `git log` five times, and invents a flag for `
21
21
  **skill-rails turns a skill into a flow.**
22
22
  Code does the steps that are always the same.
23
23
  The agent does only the steps that need judgment, one at a time.
24
- Every answer is checked against a schema before the flow goes on.
24
+ Agent outputs are checked against their declared JSON Schema before the flow goes on. Without an explicit schema, the runner checks only that the output is an object.
25
25
 
26
- | | Markdown skill | skill-rails |
26
+ ## Why use a flow instead of a Markdown-only skill?
27
+
28
+ Markdown is a good format for instructions, examples, and judgment. A Markdown skill can already call scripts and keep references in separate files. skill-rails adds an executable contract for how those pieces run together.
29
+
30
+ | Concern | Markdown-only skill | skill-rails flow |
27
31
  |---|---|---|
28
- | Order of the steps | The model remembers it | The runner enforces it |
29
- | `if` conditions and gates | The model reads them | `${{ }}` expressions, evaluated in code |
30
- | `git`, `gh`, checks, file operations | Model turns, tokens, mistakes | Scripts, with no model turn |
31
- | Values between steps | Free text in the context | JSON outputs, validated against a schema |
32
- | Questions to the user | Mixed into the prompt | Typed `ask` steps, with validated answers |
33
- | Loops, waits and reuse | "Do this for each comment", "wait for CI" | `foreach`, `run` with `until`, and `uses` to call another flow |
34
- | The skill file | One long prompt | `flow.yaml` + `scripts/` + `prompts/` that you can test and review |
32
+ | Step order | The agent interprets and follows the sequence | The runner selects the next step and rejects submissions for a different step |
33
+ | Conditions and gates | The agent evaluates the written rule or calls a script | Expressions decide which steps execute, including failure stops |
34
+ | Mechanical work | The agent calls commands or a bundled script | Consecutive shell steps execute without a model turn between them |
35
+ | Values between steps | The agent tracks values or reads script outputs | Named outputs are available to later expressions; agent outputs can have JSON Schemas |
36
+ | User questions | The agent asks and interprets replies | `ask` defines the questions and validates submitted labels or free-text values |
37
+ | Loops and reuse | Instructions or scripts describe the repetition | `foreach`, polling, and subflows make the control flow explicit |
38
+ | Testing | Scripts can be tested; prompt behavior needs separate evaluation | Fixed agent answers let tests exercise branches, scripts, files, and outputs without a model |
39
+ | Inspection and continuation | Depend on the host session and any custom scripts | `status` exposes saved progress and the pending step between calls |
40
+
41
+ For a repeated release or PR workflow, this means a missing prerequisite can stop the flow in code, a malformed output can be rejected before the next command, and a branch can be regression-tested without paying for a model run. Prompts and reference material still belong in Markdown.
35
42
 
36
43
  The flow format is the GitHub Actions syntax that you already know: `steps`, `if: ${{ }}`, `run`, `env`, `$FLOW_OUTPUT`.
37
- It runs inside the session of your agent, with its context, its tools and its permissions: you add no new service and no API key.
44
+ The agent drives the flow from its existing session: you add no new service and no API key. Shell steps execute in the runner process; with MCP, that process has its own configured environment and permissions.
38
45
 
39
46
  ## Before and after
40
47
 
@@ -111,7 +118,7 @@ What changes:
111
118
  - The gate "nothing to merge" is an `if:` that always runs, and the title is checked against `maxLength: 72`.
112
119
  - The flow can be tested with no model: see [Testing](#testing).
113
120
 
114
- The agent drives the loop from inside its own session, so the flow keeps the session context, the tools and the permissions of the agent:
121
+ The agent drives the loop from inside its own session and uses its tools for agent steps. The runner executes shell steps:
115
122
 
116
123
  ```text
117
124
  agent ── start flow.yaml ──▶ runner (runs the shell steps, then stops at the first agent step)
@@ -120,6 +127,34 @@ agent ── done <step> <json> ──▶ runner (validates the output, runs th
120
127
  agent ◀── { status: done, message } ──
121
128
  ```
122
129
 
130
+ ## Where the approach holds up—and where it does not
131
+
132
+ ### Why not just write a better Markdown skill?
133
+
134
+ For a short task, that is often the better choice. A checklist is easy to read and change, and it leaves room to adapt when the work is exploratory. A flow becomes useful when the same sequence runs repeatedly and a missed gate, malformed value, or unnecessary tool call has a meaningful cost. Maintaining YAML, schemas, scripts, and tests needs to earn its place.
135
+
136
+ ### Why not just write a script?
137
+
138
+ If all the work is mechanical, write a script. A Markdown skill that calls one well-tested script can already remove most of the model overhead. skill-rails helps when execution must alternate between code and judgment: collect context, ask the user, request a draft, validate its shape, then continue in code. Its value is coordinating those handoffs, rather than replacing shell scripts.
139
+
140
+ ### Does this make the agent deterministic?
141
+
142
+ It makes the declared control flow explicit and runner-enforced. It does not guarantee identical model answers, correct reasoning, or identical results from commands that depend on networks, time, or changing repositories. A schema can check that a title is a string under 72 characters; it cannot establish that the title accurately describes the change. Add domain checks where possible and evaluate agent quality separately.
143
+
144
+ ### Can the agent still skip a rule or claim it did the work?
145
+
146
+ The runner rejects out-of-order submissions and invalid outputs, but it trusts accepted agent reports. It cannot prove that a prompt was followed, that an answer really came from the user, or prevent the agent from acting outside the flow. It is workflow control, not a security boundary. Shell steps run with the runner process's permissions.
147
+
148
+ ### What happens after an interruption?
149
+
150
+ Saved state lets the agent retrieve the pending step and continue between completed calls. It is not a transaction log or an exactly-once execution guarantee: a command can change an external system before the updated state is saved. Make side effects safe to retry or check whether they already happened. State is local, stored in a temporary directory by default, and keyed by project directory and flow name; concurrent runs of that same flow need separate state directories.
151
+
152
+ ### Will it always be faster or cheaper?
153
+
154
+ No. Batching mechanical steps can reduce model turns, but each agent handoff still adds work, and research-heavy flows may gain little. The measurements below cover two small examples, not a general performance guarantee. Agent installation, tool timeouts, Bash availability, and skill discovery also vary; see [agent compatibility](docs/agents.md).
155
+
156
+ Start with Markdown and scripts. Add a flow when repeated handoffs, gates, and testable branches justify the extra structure.
157
+
123
158
  ## Benchmarks
124
159
 
125
160
  Two skills, each run headless 3 times as a Markdown skill and as a skill-rails flow, on the same input.
@@ -162,6 +197,10 @@ The MCP server works with any MCP client:
162
197
  { "mcpServers": { "skill-rails": { "command": "npx", "args": ["-y", "skill-rails@0.2", "mcp"] } } }
163
198
  ```
164
199
 
200
+ ## Other agents
201
+
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.
203
+
165
204
  ## Use
166
205
 
167
206
  - **Run a flow:** the `run-skill-rails` skill, the MCP tools `flow_start` and `flow_done`, or the CLI.
@@ -180,7 +219,7 @@ my-skill/
180
219
 
181
220
  ## Testing
182
221
 
183
- A flow is deterministic everywhere except in the agent steps, so you can test it with no model.
222
+ You can test the runner’s control flow with no model by supplying fixed agent answers. Use fixtures and stub commands to control external dependencies; this does not evaluate the quality of real model answers.
184
223
  A test gives the answers that the agent would give, and the runner does the rest for real: scripts, conditions, outputs and files.
185
224
 
186
225
  ```yaml
@@ -226,6 +265,7 @@ skill-rails mcp run the MCP server o
226
265
 
227
266
  - [The flow format](docs/format.md): steps, expressions, outputs, and the protocol.
228
267
  - [Testing flows](docs/testing.md): answers, fixtures, stubs and expectations.
268
+ - [Agent compatibility](docs/agents.md): setup for other agents and verification.
229
269
  - [Examples](examples/): `hello` and `open-pr`.
230
270
 
231
271
  ## Security
package/dist/api.js CHANGED
@@ -10,7 +10,7 @@ const errorReport = (error) => ({
10
10
  errors: error.errors ?? [error.message],
11
11
  });
12
12
  function save(state) {
13
- const result = report(state);
13
+ const result = { ...report(state), cwd: state.cwd };
14
14
  writeState(state);
15
15
  return result;
16
16
  }
@@ -49,7 +49,7 @@ export function done({ flow, id, output, fail, cwd = process.cwd(), exec, }) {
49
49
  export function status({ flow, cwd = process.cwd() }) {
50
50
  try {
51
51
  const state = readState(flow, cwd);
52
- return { ...report(state), results: rootResults(state) };
52
+ return { ...report(state), cwd: state.cwd, results: rootResults(state) };
53
53
  }
54
54
  catch (error) {
55
55
  return errorReport(error);
package/dist/api.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
package/dist/cli.js CHANGED
@@ -1,4 +1,5 @@
1
1
  import fs from 'node:fs';
2
+ import path from 'node:path';
2
3
  import { check, done, reset, start, status } from './api.js';
3
4
  const USAGE = `Usage:
4
5
  skill-rails start <flow.yaml> [--input <key>=<value> ...] check the flow, reset its state, print the first agent step
@@ -8,7 +9,8 @@ const USAGE = `Usage:
8
9
  skill-rails reset <flow> delete the state of a flow
9
10
  skill-rails check <flow.yaml> check a flow file without running it
10
11
  skill-rails test [<file or folder> ...] [--json] run the *.test.yaml flow tests (default: the current folder)
11
- skill-rails mcp run the MCP server on stdio`;
12
+ skill-rails mcp run the MCP server on stdio
13
+ All commands accept --cwd <project-directory>.`;
12
14
  function option(args, name) {
13
15
  const i = args.indexOf(`--${name}`);
14
16
  if (i === -1)
@@ -38,15 +40,31 @@ function outputOf(args) {
38
40
  return JSON.parse(raw === '-' ? fs.readFileSync(0, 'utf8') : raw);
39
41
  }
40
42
  export async function main(argv, print = (value) => process.stdout.write(`${JSON.stringify(value)}\n`)) {
41
- const [command, ...args] = argv;
43
+ const [command, ...rawArgs] = argv;
44
+ const args = [...rawArgs];
45
+ let explicitCwd;
46
+ const cwdIndex = args.indexOf('--cwd');
47
+ if (cwdIndex !== -1) {
48
+ explicitCwd = args[cwdIndex + 1];
49
+ if (!explicitCwd || explicitCwd.startsWith('--')) {
50
+ print({ status: 'error', errors: ['--cwd needs a project directory'] });
51
+ return 2;
52
+ }
53
+ args.splice(cwdIndex, 2);
54
+ }
42
55
  const [first, second] = args;
56
+ // npx and npm exec run the command from the nearest folder with a package.json; INIT_CWD is where the user ran it.
57
+ // Other npm and yarn commands also set INIT_CWD, for their own folder: use it only under npx or npm exec.
58
+ const launchCwd = process.env.npm_command === 'exec' && process.env.INIT_CWD ? process.env.INIT_CWD : process.cwd();
59
+ const cwd = path.resolve(launchCwd, explicitCwd ?? '.');
60
+ const file = (target) => path.resolve(cwd, target);
43
61
  let result;
44
62
  try {
45
63
  switch (command) {
46
64
  case 'start':
47
65
  if (!first || first.startsWith('--'))
48
66
  throw new Error(USAGE);
49
- result = start({ file: first, inputs: inputsOf(args) });
67
+ result = start({ file: file(first), inputs: inputsOf(args), cwd });
50
68
  break;
51
69
  case 'done': {
52
70
  if (!first || !second)
@@ -59,28 +77,28 @@ export async function main(argv, print = (value) => process.stdout.write(`${JSON
59
77
  result = { status: 'invalid', id: second, errors: [`--output is not valid JSON: ${error.message}`] };
60
78
  break;
61
79
  }
62
- result = done({ flow: first, id: second, output, fail: option(args, 'fail') });
80
+ result = done({ flow: first, id: second, output, fail: option(args, 'fail'), cwd });
63
81
  break;
64
82
  }
65
83
  case 'status':
66
84
  if (!first)
67
85
  throw new Error(USAGE);
68
- result = status({ flow: first });
86
+ result = status({ flow: first, cwd });
69
87
  break;
70
88
  case 'reset':
71
89
  if (!first)
72
90
  throw new Error(USAGE);
73
- result = reset({ flow: first });
91
+ result = reset({ flow: first, cwd });
74
92
  break;
75
93
  case 'check':
76
94
  if (!first)
77
95
  throw new Error(USAGE);
78
- result = check({ file: first });
96
+ result = check({ file: file(first) });
79
97
  break;
80
98
  case 'test': {
81
99
  const { runTests } = await import('./testing.js');
82
100
  const targets = args.filter((arg) => !arg.startsWith('--'));
83
- const results = runTests(targets.length ? targets : ['.']);
101
+ const results = runTests((targets.length ? targets : ['.']).map(file));
84
102
  if (args.includes('--json'))
85
103
  process.stdout.write(`${JSON.stringify(results)}\n`);
86
104
  else {
@@ -96,7 +114,7 @@ export async function main(argv, print = (value) => process.stdout.write(`${JSON
96
114
  }
97
115
  case 'mcp': {
98
116
  const { serve } = await import('./mcp.js');
99
- await serve();
117
+ await serve(cwd);
100
118
  return 0;
101
119
  }
102
120
  default:
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
package/dist/engine.js CHANGED
@@ -9,7 +9,10 @@ const POLL_INTERVAL_SECONDS = 30;
9
9
  const POLL_TIMEOUT_MINUTES = 30;
10
10
  const RUN_TIMEOUT_MINUTES = 10;
11
11
  // A poll gives control back to the agent after this time, so that one done call stays under the tool timeout of the agent.
12
- const waitSliceMs = () => Number(process.env.SKILL_RAILS_WAIT_SLICE_SECONDS ?? 540) * 1000;
12
+ const waitSliceMs = () => {
13
+ const seconds = Number(process.env.SKILL_RAILS_WAIT_SLICE_SECONDS ?? 20);
14
+ return (Number.isFinite(seconds) && seconds > 0 ? seconds : 20) * 1000;
15
+ };
13
16
  const sleep = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
14
17
  export class InputError extends Error {
15
18
  errors;
@@ -155,12 +158,13 @@ function failureMessage(id, exitCode, stderr) {
155
158
  /** Runs a run step once, or polls it until its condition. Returns true when the step is over. */
156
159
  function runStep(state, step, id, exec) {
157
160
  const frame = top(state);
161
+ let commandTimeoutMs = (step['timeout-minutes'] ?? RUN_TIMEOUT_MINUTES) * 60_000;
158
162
  const once = () => {
159
163
  const result = exec(step.run, {
160
164
  env: render(step.env ?? {}, contextOf(state)),
161
165
  dir: frame.dir,
162
166
  cwd: state.cwd,
163
- timeoutMs: (step.until === undefined ? (step['timeout-minutes'] ?? RUN_TIMEOUT_MINUTES) : RUN_TIMEOUT_MINUTES) * 60_000,
167
+ timeoutMs: commandTimeoutMs,
164
168
  });
165
169
  frame.results[id] = { outcome: result.outcome, exitCode: result.exitCode, outputs: result.outputs };
166
170
  state.notes.push(...result.warnings);
@@ -168,6 +172,10 @@ function runStep(state, step, id, exec) {
168
172
  };
169
173
  const fail = (message) => {
170
174
  frame.pollStarted = undefined;
175
+ frame.pollNextAt = undefined;
176
+ const result = frame.results[id];
177
+ if (result)
178
+ result.outcome = 'failure';
171
179
  if (step['continue-on-error'])
172
180
  frame.index += 1;
173
181
  else
@@ -184,27 +192,38 @@ function runStep(state, step, id, exec) {
184
192
  const deadline = frame.pollStarted + (step['timeout-minutes'] ?? POLL_TIMEOUT_MINUTES) * 60_000;
185
193
  const sliceEnd = Date.now() + waitSliceMs();
186
194
  const interval = (step['interval-seconds'] ?? POLL_INTERVAL_SECONDS) * 1000;
195
+ const wait = (retryAt) => {
196
+ state.pending = {
197
+ id, type: 'wait', retryAt,
198
+ instructions: `Step "${id}" is still waiting. Wait until ${new Date(retryAt).toISOString()}, then report it as done with no output to keep waiting.`,
199
+ };
200
+ };
187
201
  for (;;) {
202
+ const now = Date.now();
203
+ if (now >= deadline)
204
+ return fail(`Step "${id}" timed out after ${step['timeout-minutes'] ?? POLL_TIMEOUT_MINUTES} minutes.`);
205
+ if (frame.pollNextAt && now < frame.pollNextAt) {
206
+ if (frame.pollNextAt >= sliceEnd)
207
+ return wait(frame.pollNextAt);
208
+ sleep(frame.pollNextAt - now);
209
+ }
210
+ // A single poll command also fits the remaining slice and overall deadline.
211
+ commandTimeoutMs = Math.max(1, Math.min(RUN_TIMEOUT_MINUTES * 60_000, deadline - Date.now(), sliceEnd - Date.now()));
188
212
  const result = once();
189
213
  if (result.outcome === 'failure')
190
214
  return fail(failureMessage(id, result.exitCode, result.stderr));
191
215
  if (condition(step.until, contextOf(state))) {
192
216
  frame.pollStarted = undefined;
217
+ frame.pollNextAt = undefined;
193
218
  frame.index += 1;
194
219
  return;
195
220
  }
196
221
  if (Date.now() + interval > deadline) {
197
- frame.results[id].outcome = 'failure';
198
222
  return fail(`Step "${id}" timed out after ${step['timeout-minutes'] ?? POLL_TIMEOUT_MINUTES} minutes.`);
199
223
  }
200
- if (Date.now() + interval > sliceEnd) {
201
- state.pending = {
202
- id,
203
- type: 'wait',
204
- instructions: `Step "${id}" is still waiting (polls every ${interval / 1000} s). Report it as done, with no output, to keep waiting.`,
205
- };
206
- return;
207
- }
224
+ frame.pollNextAt = Date.now() + interval;
225
+ if (frame.pollNextAt >= sliceEnd)
226
+ return wait(frame.pollNextAt);
208
227
  sleep(interval);
209
228
  }
210
229
  }
@@ -1 +1 @@
1
- {"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
package/dist/mcp.d.ts CHANGED
@@ -2,4 +2,4 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  export declare function createServer({ cwd }?: {
3
3
  cwd?: string;
4
4
  }): McpServer;
5
- export declare function serve(): Promise<void>;
5
+ export declare function serve(cwd?: string): Promise<void>;
package/dist/mcp.js CHANGED
@@ -1,4 +1,5 @@
1
1
  // The MCP server: the same commands as the CLI, as tools. The working directory of the server is the project.
2
+ import path from 'node:path';
2
3
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
4
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
5
  import { z } from 'zod';
@@ -9,14 +10,14 @@ const reply = (result) => ({
9
10
  });
10
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.';
11
12
  export function createServer({ cwd = process.cwd() } = {}) {
12
- const server = new McpServer({ name: 'skill-rails', version: '0.2.0' });
13
+ const server = new McpServer({ name: 'skill-rails', version: '0.2.1' });
13
14
  server.registerTool('flow_start', {
14
15
  description: `Start a skill-rails flow: check the flow file, reset its state, and get the first step to do. ${LOOP}`,
15
16
  inputSchema: {
16
17
  file: z.string().describe('Path of the flow YAML file.'),
17
18
  inputs: z.record(z.string(), z.union([z.string(), z.boolean(), z.number()])).optional().describe('The flow inputs.'),
18
19
  },
19
- }, async ({ file, inputs }) => reply(start({ file, inputs, cwd })));
20
+ }, async ({ file, inputs }) => reply(start({ file: path.resolve(cwd, file), inputs, cwd })));
20
21
  server.registerTool('flow_done', {
21
22
  description: `Report the output of the current step of a flow, and get the next step. Give fail instead of output when you cannot do the step. ${LOOP}`,
22
23
  inputSchema: {
@@ -28,10 +29,10 @@ export function createServer({ cwd = process.cwd() } = {}) {
28
29
  }, async ({ flow, step, output, fail }) => reply(done({ flow, id: step, output, fail, cwd })));
29
30
  server.registerTool('flow_status', { description: 'Get the current step of a flow again, with the results of the steps so far.', inputSchema: { flow: z.string() } }, async ({ flow }) => reply(status({ flow, cwd })));
30
31
  server.registerTool('flow_reset', { description: 'Delete the state of a flow.', inputSchema: { flow: z.string() } }, async ({ flow }) => reply(reset({ flow, cwd })));
31
- server.registerTool('flow_check', { description: 'Check a flow file without running it.', inputSchema: { file: z.string() } }, async ({ file }) => reply(check({ file })));
32
+ server.registerTool('flow_check', { description: 'Check a flow file without running it.', inputSchema: { file: z.string() } }, async ({ file }) => reply(check({ file: path.resolve(cwd, file) })));
32
33
  return server;
33
34
  }
34
- export async function serve() {
35
- await createServer().connect(new StdioServerTransport());
35
+ export async function serve(cwd = process.cwd()) {
36
+ await createServer({ cwd }).connect(new StdioServerTransport());
36
37
  }
37
38
  //# sourceMappingURL=mcp.js.map
package/dist/mcp.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -111,6 +111,8 @@ export interface PendingStep {
111
111
  instructions?: string;
112
112
  questions?: RenderedQuestion[];
113
113
  output?: JsonObject;
114
+ /** Earliest time to resume a polling step, in Unix milliseconds. */
115
+ retryAt?: number;
114
116
  }
115
117
  /** A running list of steps: the root flow, a sub-flow, or one iteration of a foreach. */
116
118
  export interface Frame {
@@ -132,6 +134,7 @@ export interface Frame {
132
134
  }>;
133
135
  /** run steps with until: when the polling started. */
134
136
  pollStarted?: number;
137
+ pollNextAt?: number;
135
138
  }
136
139
  export interface State {
137
140
  flow: Flow;
@@ -172,7 +175,7 @@ export interface RunResult {
172
175
  }
173
176
  export type Exec = (command: string, options: RunOptions) => RunResult;
174
177
  /** What the agent reads after each command. */
175
- export type Report = ({
178
+ export type Report = (({
176
179
  status: 'step';
177
180
  flow: string;
178
181
  notes?: string[];
@@ -196,5 +199,7 @@ export type Report = ({
196
199
  } | {
197
200
  status: 'reset';
198
201
  flow: string;
202
+ }) & {
203
+ cwd?: string;
199
204
  };
200
205
  export {};
package/docs/agents.md ADDED
@@ -0,0 +1,161 @@
1
+ # Agent compatibility
2
+
3
+ skill-rails uses the same CLI, stdio MCP server, and SKILL.md instructions across agents. Node 20+ and Bash must be available where the runner executes. Windows requires a Bash environment such as WSL; native Windows is not verified. Remote agents need the package, flow files, and project checkout in their own execution environment.
4
+
5
+ ## Status
6
+
7
+ | Client | Skill discovery location (project) | Integration | Live verification |
8
+ |---|---|---|---|
9
+ | Claude Code | Plugin marketplace | Existing plugin | Not rerun for these changes |
10
+ | Codex CLI / IDE | `.agents/skills/` | CLI or stdio MCP | Pending |
11
+ | Cursor | `.cursor/skills/` | CLI or stdio MCP | Pending |
12
+ | Copilot in VS Code | `.github/skills/` | CLI or stdio MCP | Pending |
13
+ | Gemini CLI | `.gemini/skills/` | CLI or stdio MCP | Pending |
14
+ | OpenCode v2 | `.opencode/skills/` | CLI or stdio MCP | Pending |
15
+
16
+ This table describes setup targets, not certified client behavior. Copilot cloud agent, browser-only clients, and hosted remote MCP deployments are outside this initial support scope.
17
+
18
+ ## Use the current checkout
19
+
20
+ These changes must be released before published `npx` commands include them. To try them now, build this checkout:
21
+
22
+ ```bash
23
+ yarn install --immutable
24
+ yarn build
25
+ node /absolute/path/to/skill-rails/bin/skill-rails.js check /absolute/path/to/flow.yaml
26
+ ```
27
+
28
+ In the configuration examples below, replace both absolute paths. `command: node` must resolve on the client's PATH; use an absolute Node executable if necessary. Merge these entries into existing configuration rather than replacing it.
29
+
30
+ The project directory controls shell execution and state lookup. The flow path is resolved relative to that directory; supporting scripts and prompts remain relative to the flow file. Use a separate MCP server entry for each project. `start`, `done`, and `status` reports include `cwd` so the agent can check the selected workspace.
31
+
32
+ ### Codex
33
+
34
+ Register the checkout's server:
35
+
36
+ ```bash
37
+ codex mcp add skill-rails -- node /absolute/path/to/skill-rails/bin/skill-rails.js mcp --cwd /absolute/path/to/project
38
+ ```
39
+
40
+ Sources: [local skills](https://learn.chatgpt.com/docs/build-skills), [MCP](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).
41
+
42
+ ### Cursor
43
+
44
+ Add to `.cursor/mcp.json`:
45
+
46
+ ```json
47
+ {
48
+ "mcpServers": {
49
+ "skill-rails": {
50
+ "command": "node",
51
+ "args": ["/absolute/path/to/skill-rails/bin/skill-rails.js", "mcp", "--cwd", "/absolute/path/to/project"]
52
+ }
53
+ }
54
+ }
55
+ ```
56
+
57
+ Sources: [skills](https://prod.cursor.com/help/customization/skills), [MCP](https://prod.cursor.com/help/customization/mcp).
58
+
59
+ ### GitHub Copilot in VS Code
60
+
61
+ Add to `.vscode/mcp.json` (VS Code uses `servers`, not `mcpServers`):
62
+
63
+ ```json
64
+ {
65
+ "servers": {
66
+ "skill-rails": {
67
+ "type": "stdio",
68
+ "command": "node",
69
+ "args": ["/absolute/path/to/skill-rails/bin/skill-rails.js", "mcp", "--cwd", "/absolute/path/to/project"]
70
+ }
71
+ }
72
+ }
73
+ ```
74
+
75
+ Sources: [skills](https://code.visualstudio.com/docs/agent-customization/agent-skills), [MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers).
76
+
77
+ ### Gemini CLI
78
+
79
+ Merge into `.gemini/settings.json`:
80
+
81
+ ```json
82
+ {
83
+ "mcpServers": {
84
+ "skill-rails": {
85
+ "command": "node",
86
+ "args": ["/absolute/path/to/skill-rails/bin/skill-rails.js", "mcp", "--cwd", "/absolute/path/to/project"]
87
+ }
88
+ }
89
+ }
90
+ ```
91
+
92
+ Sources: [skills](https://geminicli.com/docs/cli/skills/), [MCP](https://geminicli.com/docs/tools/mcp-server/).
93
+
94
+ ### OpenCode v2
95
+
96
+ Merge into `opencode.json`. This is the v2 configuration shape; consult the matching documentation for older versions.
97
+
98
+ ```json
99
+ {
100
+ "mcp": {
101
+ "servers": {
102
+ "skill-rails": {
103
+ "type": "local",
104
+ "command": ["node", "/absolute/path/to/skill-rails/bin/skill-rails.js", "mcp", "--cwd", "/absolute/path/to/project"]
105
+ }
106
+ }
107
+ }
108
+ }
109
+ ```
110
+
111
+ Sources: [skills](https://opencode.ai/docs/skills/), [MCP](https://opencode.ai/docs/mcp-servers).
112
+
113
+ ## Install the skills
114
+
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`:
116
+
117
+ ```markdown
118
+ ---
119
+ name: run-skill-rails
120
+ description: Run a skill-rails YAML flow, one validated step at a time.
121
+ ---
122
+
123
+ Read and follow [the runner instructions](/absolute/path/to/skill-rails/skills/run-skill-rails/SKILL.md).
124
+ Use the configured skill-rails MCP tools. For CLI fallback in this checkout, replace
125
+ `npx -y skill-rails@0.2` with `node /absolute/path/to/skill-rails/bin/skill-rails.js`.
126
+ ```
127
+
128
+ Repeat for `create-skill-rails` and `migrate-to-skill-rails`, linking to their corresponding files and describing their purpose. This keeps templates and documentation beside their original skills; copying only a skill directory would break its links to `../../docs/`. After publication, wrappers can point to a stable installed package instead. Restart or reload skills in the client and verify discovery.
129
+
130
+ For CLI-only use, load the same instructions and use:
131
+
132
+ ```bash
133
+ node /absolute/path/to/skill-rails/bin/skill-rails.js start /absolute/path/to/flow.yaml --cwd /absolute/path/to/project
134
+ node /absolute/path/to/skill-rails/bin/skill-rails.js done <flow-name> <step-id> --cwd /absolute/path/to/project --output - <<'JSON'
135
+ {}
136
+ JSON
137
+ ```
138
+
139
+ Pass the same project directory to subsequent `done`, `status`, and `reset` calls. Never supply a guessed answer to an interactive step.
140
+
141
+ ## Host behavior
142
+
143
+ - Questions: use a native question tool when it supports the question. Otherwise display the question, labels, descriptions and previews in chat and wait for the user's response. Multi-select produces a list of labels; free text produces a string. Unattended flows must avoid questions or take explicit inputs that skip them.
144
+ - Skills: use the host's skill loader or read the installed named skill. If unavailable, fail the step with a reason. No Claude slash-command syntax is required.
145
+ - Polling: the default call slice is 20 seconds. A `wait` report includes `retryAt` in Unix milliseconds. Resume with `done` at or after that time. Early calls do not execute the check early. `SKILL_RAILS_WAIT_SLICE_SECONDS` adjusts the slice; a poll command exceeding the remaining slice fails, so checks should be short.
146
+ - Ordinary `run` steps still have their own timeout (default 10 minutes); multiple steps can execute in one call. The polling slice is not a global tool-call deadline. For long work, launch a background job and poll its status, or configure the host timeout to fit the flow.
147
+ - Execution: shell commands run with the runner process's permissions. An MCP client's per-command approval and sandbox rules do not necessarily apply inside the MCP server. Review scripts and configure the server environment accordingly.
148
+
149
+ ## Repeatable client smoke test
150
+
151
+ Use a disposable project and this checkout's `examples/hello/flow.yaml`:
152
+
153
+ 1. Confirm all three skills are discoverable and the create skill can read its format reference and template.
154
+ 2. Ask the runner skill to start `hello`, using the intended project. Check `cwd` in the report.
155
+ 3. Confirm the greeting question appears and the agent waits. Choose `Good`; complete the poem and verify the final message. Repeat with `Bad` and verify the poem step is skipped.
156
+ 4. Through MCP or CLI, submit an invalid poem output, verify `invalid`, then submit a valid output and finish. Check `status` after restarting the client.
157
+ 5. Exercise a flow with a `skill` step using a small installed skill, then an unavailable skill; confirm the latter fails clearly.
158
+ 6. Exercise a polling flow with a 30-second interval. Check that it returns `wait`, preserves `retryAt` across `status`, and resumes when due without an early check.
159
+ 7. Run the CLI fallback from a different directory with `--cwd` and confirm files and state belong to the selected project.
160
+
161
+ Record client version, OS, transport, date, and results before marking a client verified. Automated CLI, in-memory MCP, schema validation, and polling tests validate the protocol; they do not establish that a particular model follows the skills correctly.
package/docs/format.md CHANGED
@@ -85,8 +85,8 @@ A `run` step with `until` runs its command again until the condition is true: fo
85
85
 
86
86
  - In `until`, `steps.<id>` holds the result of the last run.
87
87
  - A run that fails (exit code not 0) ends the polling as a failure: report "not ready yet" in an output, not with the exit code.
88
- - The runner gives control back to the agent after 9 minutes (`SKILL_RAILS_WAIT_SLICE_SECONDS`), so that one command stays under the tool timeout of the agent.
89
- The agent then gets a `wait` step: it reports it as done, with no output, and the polling goes on.
88
+ - The runner uses a 20-second polling slice (`SKILL_RAILS_WAIT_SLICE_SECONDS`). Each poll command is limited to the remaining slice and overall polling deadline; an overlong command fails. Keep status checks short.
89
+ The agent gets a `wait` step with `retryAt` (Unix milliseconds). It waits until that time, then reports the step as done with no output. Early calls preserve the scheduled check. Ordinary non-polling commands retain their own timeout; this is not a global call deadline.
90
90
 
91
91
  ### `prompt`
92
92
 
@@ -110,7 +110,7 @@ The agent follows the instructions, then reports an output.
110
110
 
111
111
  ### `skill`
112
112
 
113
- The agent invokes another skill with `with` as its arguments, then follows the optional `prompt` or `prompt-file`.
113
+ The agent loads and follows another installed skill through its host’s supported mechanism, with `with` as its arguments, then follows the optional `prompt` or `prompt-file`. If the skill is unavailable, the agent reports failure.
114
114
 
115
115
  ```yaml
116
116
  - id: review
@@ -124,7 +124,7 @@ When the other skill only runs a script, call the script in a `run` step: it cos
124
124
 
125
125
  ### `ask`
126
126
 
127
- The agent asks the user one or more multiple-choice questions.
127
+ The agent asks the user one or more questions using a native question tool or chat if the tool cannot represent them. It waits for the reply before reporting an answer.
128
128
 
129
129
  ```yaml
130
130
  - id: confirm
@@ -252,5 +252,7 @@ Each command prints one JSON object.
252
252
 
253
253
  A result can also have `notes`: the warnings of the run steps, which the agent shows to the user.
254
254
 
255
+ CLI commands accept `--cwd <project-directory>`, including `mcp` to bind the server to a project. Paths are relative to this directory. Reports from `start`, `done`, and `status` include `cwd`.
256
+
255
257
  The state is a JSON file per flow name and working directory, in `$SKILL_RAILS_STATE_DIR` (default: the system temp folder).
256
258
  `start` resets it.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skill-rails",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Deterministic, testable YAML flows for AI agent skills, in GitHub Actions syntax.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -7,7 +7,9 @@ argument-hint: "<what the skill does>"
7
7
  # Create a skill with skill-rails
8
8
 
9
9
  Writes a new skill folder: `SKILL.md`, `flow.yaml`, `scripts/` and `prompts/`.
10
- Read `${CLAUDE_SKILL_DIR}/../../docs/format.md` first: it is the reference of the flow format.
10
+ Read [the flow format](../../docs/format.md) first: it is the reference of the flow format.
11
+
12
+ Resolve relative links from this SKILL.md file, not from the project working directory. Keep the package’s `skills/` and `docs/` layout together.
11
13
 
12
14
  ## Step 1: Understand the skill
13
15
 
@@ -17,7 +19,7 @@ Ask the user only for the ones that it does not give:
17
19
  - what the skill does, its inputs, and its result;
18
20
  - whether it runs with a user (it can ask questions) or unattended (it never asks);
19
21
  - the tools and other skills that it uses;
20
- - where to write it (for example `.claude/skills/<name>/` or a plugin `skills/` folder).
22
+ - where to write it (the host agent’s skill directory or a plugin `skills/` folder).
21
23
 
22
24
  ## Step 2: Design the steps
23
25
 
@@ -49,7 +51,7 @@ Show the design to the user as a table of steps (id, type, what it does) before
49
51
  Print `::warning::<text>` for a message to the user.
50
52
  Make each script executable.
51
53
  - `prompts/<id>.md`: the instructions, with `${{ }}` for the values of earlier steps.
52
- - `SKILL.md`: copy `${CLAUDE_SKILL_DIR}/template/SKILL.md` and fill the name, the description and the inputs.
54
+ - `SKILL.md`: copy [the template](template/SKILL.md) and fill the name, the description and the inputs.
53
55
 
54
56
  Rules:
55
57
 
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: <skill-name>
3
3
  description: "<What the skill does, and when to use it.>"
4
- allowed-tools: Bash, Read, Edit, Write
5
4
  ---
6
5
 
7
6
  # <Skill title>
@@ -9,16 +8,19 @@ allowed-tools: Bash, Read, Edit, Write
9
8
  This skill runs `flow.yaml` with skill-rails.
10
9
  Run the flow with the `run-skill-rails` skill, or follow these steps.
11
10
 
11
+ Resolve [flow.yaml](flow.yaml) relative to this SKILL.md and substitute its absolute directory below. Run commands in the intended project directory; add `--cwd <project-directory>` when needed.
12
+
12
13
  1. Start the flow:
13
14
 
14
15
  ```bash
15
- npx -y skill-rails@0.2 start "${CLAUDE_SKILL_DIR}/flow.yaml" [--input <key>=<value> ...]
16
+ npx -y skill-rails@0.2 start "<absolute-path-to-this-skill>/flow.yaml" [--input <key>=<value> ...]
16
17
  ```
17
18
 
18
19
  2. Act on the `status` of each result:
19
20
  - `step` → do the step, then run `npx -y skill-rails@0.2 done <flow> <id> --output - <<'JSON' ... JSON` with an output that matches `output`.
20
- For a `skill` step, invoke the skill with `args` first.
21
- For an `ask` step, ask the `questions` as they are, and report one property per question id.
21
+ For a `skill` step, load and follow the named skill using the host’s supported mechanism with `args` first; report failure if unavailable.
22
+ For an `ask` step, ask the `questions` as they are, display descriptions and previews, wait for the user’s reply, and report one property per question id. Use chat when a question tool cannot represent the question. Never invent an answer.
23
+ For a `wait` step, wait until `retryAt` (Unix milliseconds), then report it done with no output.
22
24
  - `invalid` → correct the output and run `done` again.
23
25
  - `done`, `failed` or `error` → tell the user `message` or `errors`, and stop.
24
26
  3. Do only the step that the runner gives you, and never run the shell steps of the flow yourself.
@@ -7,8 +7,10 @@ argument-hint: "<path of the skill folder or SKILL.md>"
7
7
  # Migrate a skill to skill-rails
8
8
 
9
9
  Turns a Markdown skill into a flow skill, next to the original: `<name>-flow/` with `SKILL.md`, `flow.yaml`, `scripts/` and `prompts/`.
10
- Keep the original skill until the comparison in Step 6 shows that the flow gives the same result.
11
- Read `${CLAUDE_SKILL_DIR}/../../docs/format.md` first: it is the reference of the flow format.
10
+ Keep the original skill until deterministic tests and the rule audit show that the flow preserves its behavior; use the optional live comparison in Step 6 for additional evidence.
11
+ Read [the flow format](../../docs/format.md) first: it is the reference of the flow format.
12
+
13
+ Resolve relative links from this SKILL.md file, not from the project working directory. Keep the package’s `skills/` and `docs/` layout together.
12
14
 
13
15
  ## Step 1: Read the skill
14
16
 
@@ -68,11 +70,8 @@ Do not run a step that publishes something (push, PR, message) during a test.
68
70
  ## Step 6: Compare
69
71
 
70
72
  Compare the two versions on the same input, when the user agrees to the cost.
71
- A headless run gives the numbers:
72
-
73
- ```bash
74
- claude -p "/<plugin>:<skill> <args>" --output-format json --no-session-persistence --settings '{"disableAllHooks": true}' --strict-mcp-config
75
- ```
73
+ Use the current agent's documented headless mode if available; otherwise compare in separate interactive sessions. Do not assume another agent CLI is installed. Report only metrics the host exposes.
74
+ First add deterministic `*.test.yaml` cases and run `skill-rails test`; these need no model. Live comparisons are optional and require the user's agreement to the cost.
76
75
 
77
76
  Run each version at least 3 times, in a copy of the repository, and compare the result (the files or the PR), the duration, the turns, the tokens and the cost.
78
77
  Give the user the table, the rule list from Step 3, and the differences in the result.
@@ -9,6 +9,8 @@ argument-hint: "<flow.yaml> [key=value ...]"
9
9
  The runner decides the order of the steps, runs the shell steps itself, and checks each output that you report.
10
10
  You do only the step that it gives you, one at a time.
11
11
 
12
+ Resolve the caller’s flow path relative to its SKILL.md when it supplies a relative link. Use the intended project directory for execution and state; with the CLI, add `--cwd <project-directory>` to each command if needed. With MCP, the server must be configured for that project.
13
+
12
14
  Use the MCP tools `flow_start` and `flow_done` when they are available.
13
15
  Otherwise use the CLI: `npx -y skill-rails@0.2 <command>`.
14
16
 
@@ -45,13 +47,13 @@ When the object has `notes`, tell them to the user.
45
47
  ### Step types
46
48
 
47
49
  - `prompt` → do `instructions`.
48
- - `skill` → invoke `skill` with `args`, then do `instructions`.
50
+ - `skill` → load and follow the named `skill` with `args` using the host’s supported mechanism, then do `instructions`. If unavailable, report the step with `--fail`; do not silently substitute another skill.
49
51
  If the skill tells you to stop, report the step with `--fail`.
50
- - `ask` → ask the user `questions` as they are, with your question tool, with each option `preview`.
52
+ - `ask` → ask the user `questions` as they are, including option descriptions and each `preview`. Use a native question tool when it can represent the question; otherwise ask in chat. Wait for the user’s reply before reporting an answer. Never infer approval or invent a selection.
51
53
  Report one property per question `id`: the selected label, or the list of labels for `multiSelect`.
52
54
  A question with `free: true` takes free text: ask it in a normal message, wait for the reply, and report the reply as text.
53
55
  - `wait` → a step polls a command and needs more time.
54
- Run `done <flow> <id>` again with no output, with a tool timeout of 10 minutes.
56
+ Wait until `retryAt` (Unix milliseconds), using the host’s wait mechanism, then run `done <flow> <id>` with no output. If the host cannot wait automatically, hand control back and resume when the user returns.
55
57
 
56
58
  `output` is the JSON Schema of the output: report a JSON object that matches it.
57
59