@juicesharp/rpiv-args 1.1.3 → 1.1.5

package/README.md

@@ -11,7 +11,7 @@
 [![npm version](https://img.shields.io/npm/v/@juicesharp/rpiv-args.svg)](https://www.npmjs.com/package/@juicesharp/rpiv-args)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Pass arguments to your skills like a shell command. `rpiv-args` adds `$1`, `$ARGUMENTS`, `$@`, `${@:N}`, and `${@:N:L}` placeholders to [Pi Agent](https://github.com/badlogic/pi-mono) skills — write `/skill:deploy api production` and your skill body sees `$1` = `api`, `$2` = `production`. Skills without placeholders are untouched, so installing `rpiv-args` is safe for any existing skill collection.
+Pass arguments to your skills like a shell command. `rpiv-args` adds `$1`, `$ARGUMENTS`, `$@`, `${@:N}`, and `${@:N:L}` placeholders to [Pi Agent](https://github.com/badlogic/pi-mono) skills - write `/skill:deploy api production` and your skill body sees `$1` = `api`, `$2` = `production`. Skills without placeholders are untouched, so installing `rpiv-args` is safe for any existing skill collection.
 
 ## Install
 
@@ -31,7 +31,7 @@ Or run `/rpiv-setup` if you have `@juicesharp/rpiv-pi` installed.
 | `${@:N}` | Arguments from position N onward | `/skill:foo a b c` → `${@:2}` = `b c` |
 | `${@:N:L}` | L arguments starting at position N | `/skill:foo a b c d` → `${@:2:2}` = `b c` |
 
-**Indexing is 1-based** — `$1` is the first argument, `$2` is the second.
+**Indexing is 1-based** - `$1` is the first argument, `$2` is the second.
 Out-of-range positions resolve to an empty string. For `${@:N[:L]}`, `N` is
 clamped to `≥ 1` and out-of-range slices yield an empty string.
 
@@ -51,14 +51,14 @@ expansion). When a skill body contains at least one placeholder, the extension:
 1. Parses arguments using shell-style quoting
 2. Substitutes all placeholders in the body
 3. Wraps the result in a `<skill>` block byte-identical to Pi's native format
-4. Appends the raw arguments after the block — matches Pi's standard output so any tool that parses `<skill>` blocks continues to work unchanged
+4. Appends the raw arguments after the block - matches Pi's standard output so any tool that parses `<skill>` blocks continues to work unchanged
 
 When no placeholders are found in the skill body, the output is byte-identical
-to Pi's built-in expansion — zero behavioral change.
+to Pi's built-in expansion - zero behavioral change.
 
 ## Writing skills with arguments
 
-### `$ARGUMENTS` vs `$1` — which to use
+### `$ARGUMENTS` vs `$1` - which to use
 
 Use **`$ARGUMENTS`** (or `$@`) when the input is freeform text the LLM should
 interpret naturally:
@@ -104,7 +104,7 @@ If a positional skill receives natural language input:
 /skill:migrate-component can you migrate the search bar please
 ```
 
-→ `Migrate the can component from you to migrate.` — **broken**.
+→ `Migrate the can component from you to migrate.` - **broken**.
 
 The LLM is good at interpreting `$ARGUMENTS` as a whole, but positional
 placeholders blindly split on spaces. Use `$ARGUMENTS` unless your skill has
@@ -130,17 +130,17 @@ argument-hint: [component] [from] [to]
 ---
 ```
 
-rpiv-args ignores this field — substitution is triggered by placeholders in the body, not the hint.
+rpiv-args ignores this field - substitution is triggered by placeholders in the body, not the hint.
 
 **Note**: Pi currently surfaces `argument-hint` in autocomplete for prompt
 templates (`commands/*.md`) but **not** for skills (`/skill:<name>`). The
 field is read by Pi but not displayed in the `/skill:` autocomplete UI at
-present — treat it as documentation metadata until upstream Pi exposes it.
+present - treat it as documentation metadata until upstream Pi exposes it.
 
 ### Full example
 
 <details>
-<summary>Deploy skill — SKILL.md, invocation, and the exact text the LLM sees</summary>
+<summary>Deploy skill - SKILL.md, invocation, and the exact text the LLM sees</summary>
 
 ```yaml
 ---
@@ -179,7 +179,7 @@ api production
 ```
 
 Note: the raw arguments (`api production`) are also appended after the
-`</skill>` block — this is Pi's standard behavior and is preserved for
+`</skill>` block - this is Pi's standard behavior and is preserved for
 backward compatibility.
 
 </details>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@juicesharp/rpiv-args",
-  "version": "1.1.3",
-  "description": "Pi extension: pass shell-style $1 / $ARGUMENTS placeholders to your Pi skills",
+  "version": "1.1.5",
+  "description": "Pi extension. Shell-style $1 and $ARGUMENTS placeholders, expanded into your Pi skills at invocation.",
   "keywords": [
     "pi-package",
     "pi-extension",