@promptscript/cli 1.12.1 → 1.13.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 +64 -35
- package/index.js +874 -378
- package/package.json +3 -2
- package/skills/promptscript/SKILL.md +6 -2
- package/src/cli.d.ts.map +1 -1
- package/src/commands/compile.d.ts.map +1 -1
- package/src/commands/skills.d.ts.map +1 -1
- package/src/prettier/index.d.ts +1 -0
- package/src/prettier/index.d.ts.map +1 -1
- package/src/prettier/post-format.d.ts +23 -0
- package/src/prettier/post-format.d.ts.map +1 -0
- package/src/types.d.ts +8 -0
- package/src/types.d.ts.map +1 -1
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
[](https://youtu.be/7sHMn-DbZig)
|
|
10
10
|
|
|
11
|
-
PromptScript is the Terraform for AI instructions. Write your standards once in `.prs` files, compile to GitHub Copilot, Claude Code, Cursor, and 34 more agents
|
|
11
|
+
PromptScript is the Terraform for AI instructions. Write your standards once in `.prs` files, compile to GitHub Copilot, Claude Code, Cursor, and 34 more agents, with inheritance, composition, **skills, sub-agents**, validation, lockfile, and version control built in.
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
@@ -52,10 +52,10 @@ prs compile # outputs to all configured AI tools
|
|
|
52
52
|
Then install hooks for fully automatic workflow:
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
prs hooks install
|
|
55
|
+
prs hooks install --all # auto-compile on .prs save, block AI from overwriting outputs
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
Three commands. Every AI tool configured. Your AI agents automatically learn PromptScript syntax via a bundled language skill
|
|
58
|
+
Three commands. Every AI tool configured. Your AI agents automatically learn PromptScript syntax via a bundled language skill, they can manage your `.prs` files for you.
|
|
59
59
|
|
|
60
60
|
### Already have CLAUDE.md or .cursorrules?
|
|
61
61
|
|
|
@@ -94,7 +94,7 @@ Import entire skill directories at once:
|
|
|
94
94
|
|
|
95
95
|
@inherit @company/backend-security
|
|
96
96
|
@use @fragments/testing
|
|
97
|
-
@use
|
|
97
|
+
@use github.com/anthropics/skills/code-review.md@1.0.0
|
|
98
98
|
|
|
99
99
|
@identity {
|
|
100
100
|
"""
|
|
@@ -109,12 +109,20 @@ Import entire skill directories at once:
|
|
|
109
109
|
}
|
|
110
110
|
|
|
111
111
|
@skills {
|
|
112
|
-
|
|
113
|
-
description: "
|
|
112
|
+
security-audit: {
|
|
113
|
+
description: "OWASP Top 10 vulnerability scan"
|
|
114
114
|
userInvocable: true
|
|
115
|
-
allowedTools: ["
|
|
115
|
+
allowedTools: ["Read", "Grep", "Bash"]
|
|
116
|
+
references: ["./refs/owasp-top10.md"]
|
|
117
|
+
inputs: { target_path: string }
|
|
118
|
+
outputs: { findings: array, severity: enum }
|
|
116
119
|
}
|
|
117
120
|
}
|
|
121
|
+
|
|
122
|
+
@agents {
|
|
123
|
+
reviewer: { description: "PR reviewer" }
|
|
124
|
+
debugger: { description: "Test failure triage" }
|
|
125
|
+
}
|
|
118
126
|
```
|
|
119
127
|
|
|
120
128
|
Run `prs compile` and get correctly formatted output for every AI tool your team uses.
|
|
@@ -139,37 +147,58 @@ Plus **30 more**: Windsurf, Cline, Roo Code, Codex, Continue, Augment, and other
|
|
|
139
147
|
|
|
140
148
|
## Key Features
|
|
141
149
|
|
|
142
|
-
| Feature | What it does
|
|
143
|
-
| :--------------------------- |
|
|
144
|
-
| **Inheritance** | Org -> team -> project configs that cascade like CSS
|
|
145
|
-
| **Composition** | Reuse fragments and skills with `@use`
|
|
146
|
-
| **Markdown imports** | `@use` plain `.md` files and GitHub skills directly
|
|
147
|
-
| **Parameterized templates** | `@inherit @stacks/node(port: 8080, db: "postgres")`
|
|
148
|
-
| **Skills** | SKILL.md files with resource bundles
|
|
149
|
-
| **
|
|
150
|
-
| **
|
|
151
|
-
| **
|
|
152
|
-
| **
|
|
153
|
-
| **
|
|
154
|
-
| **
|
|
150
|
+
| Feature | What it does |
|
|
151
|
+
| :--------------------------- | :----------------------------------------------------------------------------- |
|
|
152
|
+
| **Inheritance** | Org -> team -> project configs that cascade like CSS |
|
|
153
|
+
| **Composition** | Reuse fragments and skills with `@use` |
|
|
154
|
+
| **Markdown imports** | `@use` plain `.md` files and GitHub skills directly |
|
|
155
|
+
| **Parameterized templates** | `@inherit @stacks/node(port: 8080, db: "postgres")` |
|
|
156
|
+
| **Skills** | SKILL.md files with resource bundles, tool permissions, input/output contracts |
|
|
157
|
+
| **Sub-agents** | `@agents` block compiles to Claude / Factory native agents |
|
|
158
|
+
| **Multi-target compilation** | One source, any number of AI tools (37 supported) |
|
|
159
|
+
| **Hooks** | `prs hooks install --all` auto-recompiles + protects outputs |
|
|
160
|
+
| **Watch mode** | `prs compile -w` for instant recompilation |
|
|
161
|
+
| **Overwrite protection** | Never accidentally clobbers hand-written files |
|
|
162
|
+
| **Validation** | `prs validate --strict --format json` for CI |
|
|
163
|
+
| **Registry support** | Share configs via Git registries (private or public) |
|
|
164
|
+
| **Lockfile** | `promptscript.lock` for reproducible builds across repos |
|
|
165
|
+
| **Vendor mode** | `prs vendor sync` for offline / air-gapped CI |
|
|
166
|
+
| **Migration** | Import existing CLAUDE.md, .cursorrules with `prs import` |
|
|
155
167
|
|
|
156
168
|
## Commands
|
|
157
169
|
|
|
158
|
-
| Command
|
|
159
|
-
|
|
|
160
|
-
| `prs init`
|
|
161
|
-
| `prs compile`
|
|
162
|
-
| `prs compile -w`
|
|
163
|
-
| `prs compile --dry-run`
|
|
164
|
-
| `prs
|
|
165
|
-
| `prs
|
|
166
|
-
| `prs
|
|
167
|
-
| `prs
|
|
168
|
-
| `prs
|
|
169
|
-
| `prs
|
|
170
|
-
| `prs diff`
|
|
171
|
-
| `prs
|
|
172
|
-
| `prs
|
|
170
|
+
| Command | Description |
|
|
171
|
+
| :------------------------------------ | :----------------------------------------------------- |
|
|
172
|
+
| `prs init` | Initialize project with auto-detection |
|
|
173
|
+
| `prs compile` | Compile to all target formats |
|
|
174
|
+
| `prs compile -w` | Watch mode, recompile on changes |
|
|
175
|
+
| `prs compile --dry-run` | Preview without writing files |
|
|
176
|
+
| `prs compile --strict` | Fail on output path conflicts |
|
|
177
|
+
| `prs build <profile>` | Compile a named build profile from `promptscript.yaml` |
|
|
178
|
+
| `prs validate` | Validate `.prs` files with detailed errors |
|
|
179
|
+
| `prs validate --strict --format json` | Machine-readable output for CI pipelines |
|
|
180
|
+
| `prs validate --fix` | Auto-fix syntax version mismatches |
|
|
181
|
+
| `prs inspect <skill>` | Show skill composition layers and provenance |
|
|
182
|
+
| `prs diff` | Show diff between source and compiled output |
|
|
183
|
+
| `prs check` | Check configuration and dependencies health |
|
|
184
|
+
| `prs hooks install --all` | Install auto-compile + overwrite-protection hooks |
|
|
185
|
+
| `prs hooks uninstall <tool>` | Remove hooks for a specific tool |
|
|
186
|
+
| `prs lock` | Generate / update `promptscript.lock` |
|
|
187
|
+
| `prs lock --update` | Force re-hash of all registry references |
|
|
188
|
+
| `prs update [package]` | Re-resolve versions and update lockfile |
|
|
189
|
+
| `prs vendor sync` | Mirror all cached deps to `.promptscript/vendor/` |
|
|
190
|
+
| `prs vendor check` | Verify vendor directory matches lockfile |
|
|
191
|
+
| `prs skills add <source>` | Add a remote skill (GitHub URL or alias) |
|
|
192
|
+
| `prs skills list` | List installed skills |
|
|
193
|
+
| `prs skills update [name]` | Update markdown-sourced skill lock entries |
|
|
194
|
+
| `prs skills remove <name>` | Remove a skill from the project |
|
|
195
|
+
| `prs registry ...` | Manage registries (publish, add, list) |
|
|
196
|
+
| `prs resolve <import>` | Show full resolution chain for an import (debug) |
|
|
197
|
+
| `prs import` | Import existing AI instruction files |
|
|
198
|
+
| `prs migrate` | Migrate all existing instructions at once |
|
|
199
|
+
| `prs upgrade` | Upgrade `.prs` files to latest syntax version |
|
|
200
|
+
| `prs pull` | Pull updates from registry |
|
|
201
|
+
| `prs serve` | Start local playground server |
|
|
173
202
|
|
|
174
203
|
## Configuration
|
|
175
204
|
|