@promptscript/cli 1.3.0 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptscript/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
   "keywords": [
     "cli",

package/skills/promptscript/SKILL.md

@@ -211,7 +211,108 @@ Reusable skill definitions with metadata:
 ```
 
 Properties: description (required), content (required), trigger, disableModelInvocation,
-userInvocable, allowedTools, context ("fork" or "inherit"), agent.
+userInvocable, allowedTools, context ("fork" or "inherit"), agent, requires, inputs, outputs.
+
+### Parameterized Skills
+
+Skills in `.promptscript/skills/<name>/SKILL.md` support template parameters via
+YAML frontmatter. Define `params` in frontmatter and use `{{variable}}` in content:
+
+```yaml
+---
+name: review
+description: 'Review {{language}} code for {{standard}}'
+params:
+  language:
+    type: string
+  standard:
+    type: string
+    default: 'best practices'
+---
+Review the code using {{language}} conventions following {{standard}}.
+```
+
+Pass values in `@skills` block:
+
+```
+@skills {
+  review: {
+    description: "Review code"
+    language: "typescript"
+    standard: "strict mode"
+  }
+}
+```
+
+Non-reserved properties (anything other than description, content, trigger,
+userInvocable, allowedTools, disableModelInvocation, context, agent, requires,
+inputs, outputs) are treated as skill parameter arguments.
+
+### Skill Dependencies
+
+Skills can declare dependencies on other skills via `requires`:
+
+```
+@skills {
+  deploy: {
+    description: "Deploy service"
+    requires: ["lint-check", "test-suite"]
+    content: (triple-quoted text)
+  }
+}
+```
+
+The validator (PS016) checks that required skills exist, detects self-references,
+and catches circular dependency chains.
+
+### Skill Contracts (Inputs/Outputs)
+
+Skills can declare typed inputs and outputs in SKILL.md frontmatter:
+
+```yaml
+---
+name: security-scan
+description: 'Scan for vulnerabilities'
+inputs:
+  files:
+    description: 'Files to scan'
+    type: string
+  severity:
+    description: 'Minimum severity'
+    type: enum
+    options: [low, medium, high]
+    default: medium
+outputs:
+  report:
+    description: 'Scan report'
+    type: string
+  passed:
+    description: 'Whether scan passed'
+    type: boolean
+---
+```
+
+Field types: `string`, `number`, `boolean`, `enum` (with `options` list).
+The validator (PS017) checks field types, ensures enum fields have options,
+and warns if param names collide with input names.
+
+### Shared Resources
+
+Skills in a folder can share common resources via `.promptscript/shared/`:
+
+```
+.promptscript/
+  shared/
+    templates.md         # Shared across all skills
+    style-guide.md
+  skills/
+    review/
+      SKILL.md           # Gets @shared/templates.md, @shared/style-guide.md
+    deploy/
+      SKILL.md           # Also gets shared resources
+```
+
+Files in `shared/` are automatically included in every skill with `@shared/` prefix.
 
 ### @agents
 
@@ -297,10 +398,79 @@ Requires an aliased @use:
 }
 ```
 
+### Parameterized Inheritance (Template Variables)
+
+Use `{{variable}}` placeholders in a **parent/template** file, and pass values
+from the **child** file via `@inherit` or `@use` with `(key: value)` syntax.
+
+**IMPORTANT:** Variables are NOT set from `promptscript.yaml` or CLI. They are
+passed from one `.prs` file to another through `@inherit` or `@use`.
+
+**Step 1: Create the template** (parent file with `params` in `@meta`):
+
+```
+# base.prs — reusable template
+@meta {
+  id: "service-template"
+  syntax: "1.0.0"
+  params: {
+    serviceName: string
+    port?: number = 3000
+  }
+}
+
+@identity {
+  """
+  You are working on {{serviceName}} running on port {{port}}.
+  """
+}
+```
+
+**Step 2: Inherit with values** (child file passes params):
+
+```
+# project.prs — concrete project
+@meta { id: "user-api" syntax: "1.0.0" }
+
+@inherit ./base(serviceName: "user-api", port: 8080)
+```
+
+After compilation, `{{serviceName}}` becomes `user-api` and `{{port}}` becomes `8080`.
+
+The same works with `@use`:
+
+```
+@use ./base(serviceName: "auth-service") as auth
+```
+
+**Parameter types:** `string`, `number`, `boolean`, `enum("a", "b")`.
+Optional params use `?` suffix. Defaults use `= value`.
+Missing required params produce a compile error.
+
+**Multi-service pattern** — reuse one template across many projects:
+
+```
+services/
+  base.prs                          # template with params
+  user-api/
+    promptscript.yaml               # source: project.prs
+    project.prs                     # @inherit ../base(serviceName: "user-api")
+  auth-service/
+    promptscript.yaml
+    project.prs                     # @inherit ../base(serviceName: "auth-service")
+```
+
 ## Configuration: promptscript.yaml
 
+### Auto-injection
+
+This skill is automatically included when compiling with `prs compile`. No manual copying needed.
+To disable, set `includePromptScriptSkill: false` in your `promptscript.yaml`.
+
 ```
-version: '1'
+id: my-project
+syntax: "1.1.0"
+description: "My project description"
 input:
   entry: .promptscript/project.prs
   include: ['.promptscript/**/*.prs']
@@ -332,6 +502,8 @@ prs init --migrate          # Initialize + migration skills
 prs compile                 # Compile to all targets
 prs compile --watch         # Watch mode
 prs validate --strict       # Validate syntax
+prs import CLAUDE.md        # Import existing AI instructions
+prs import --dry-run        # Preview import conversion
 prs pull                    # Update registry
 prs diff --target claude    # Show compilation diff
 ```
@@ -356,6 +528,15 @@ prs diff --target claude    # Show compilation diff
 | Continue    | .continue/rules/project.md      | .continue/skills/\*/SKILL.md                       |
 | + 26 more   |                                 | See full list in documentation                     |
 
+### Formatter Documentation
+
+For detailed information about each formatter's output paths, supported features, quirks, and example outputs:
+
+- **Full formatter reference:** `docs/reference/formatters/` (7 dedicated pages + index of all 37)
+- **llms-full.txt:** Available at the docs site root — contains all documentation in a single file for LLM consumption
+- **Dedicated pages exist for:** Claude Code, GitHub Copilot, Cursor, Antigravity, Factory AI, Gemini CLI, OpenCode
+- **All 37 formatters indexed at:** `docs/reference/formatters/index.md` with output paths, tier, and feature flags
+
 ## Project Organization
 
 Typical modular structure:
@@ -379,3 +560,56 @@ The entry file uses `@use ./context`, `@use ./standards`, etc. to compose them.
 4. Unquoted strings with special chars - quote strings containing `:`, `#`, `{`, `}`
 5. Forgetting to compile - `.prs` changes need `prs compile` to take effect
 6. Triple quotes inside triple quotes - not supported; describe content textually instead
+7. Using `{{var}}` in the root file without `@inherit` - template variables only work
+   in a parent file that defines `params` in `@meta`, with values passed by the child
+   via `@inherit ./parent(key: value)` or `@use ./fragment(key: value)`. They are NOT
+   set from `promptscript.yaml` or CLI flags
+
+## Migrating Existing AI Instructions to PromptScript
+
+### Automated: `prs import`
+
+The fastest way to convert existing AI instructions to PromptScript:
+
+```
+prs import CLAUDE.md                    # Convert a single file
+prs import .github/copilot-instructions.md
+prs import AGENTS.md --output ./imported.prs
+prs import --dry-run CLAUDE.md          # Preview without writing
+```
+
+`prs import` automatically:
+
+- Detects the source format (Claude, GitHub Copilot, Cursor, Factory, etc.)
+- Maps content to appropriate PromptScript blocks (@identity, @standards, etc.)
+- Generates a valid `.prs` file with `@meta` block
+- Preserves the original intent and structure
+
+Supported source formats:
+
+- `CLAUDE.md` (Claude Code)
+- `.github/copilot-instructions.md` (GitHub Copilot)
+- `.cursorrules` or `.cursor/rules/*.mdc` (Cursor)
+- `AGENTS.md` (Factory AI / Codex)
+- `.clinerules` (Cline), `.roorules` (Roo Code)
+- `.windsurf/rules/*.md` (Windsurf)
+- Any Markdown-based AI instruction file
+
+### Manual Migration
+
+For complex migrations or when `prs import` needs refinement:
+
+| Source Pattern                      | PromptScript Block |
+| ----------------------------------- | ------------------ |
+| "You are..." persona text           | `@identity`        |
+| Project description, tech stack     | `@context`         |
+| Coding conventions, style rules     | `@standards`       |
+| "Never...", "Always...", hard rules | `@restrictions`    |
+| `/command` definitions              | `@shortcuts`       |
+| Skill/tool definitions              | `@skills`          |
+| Agent/subagent configs              | `@agents`          |
+| Reference docs, API specs           | `@knowledge`       |
+
+After import, split into modular files (`context.prs`, `standards.prs`, etc.)
+and compose with `@use` in `project.prs`. Run `prs validate --strict` then
+`prs compile` to verify output matches the original.

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAmIA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CAEvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAyJA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CAEvD"}

package/src/commands/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/compile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAgVzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA8Gf"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/compile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAkXzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwHf"}

package/src/commands/import.d.ts

@@ -0,0 +1,8 @@
+export interface ImportCommandOptions {
+    format?: string;
+    output?: string;
+    dryRun?: boolean;
+    validate?: boolean;
+}
+export declare function importCommand(file: string, options: ImportCommandOptions): Promise<void>;
+//# sourceMappingURL=import.d.ts.map

package/src/commands/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/import.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9F"}

package/src/commands/index.d.ts

@@ -3,4 +3,5 @@ export { compileCommand } from './compile.js';
 export { validateCommand } from './validate.js';
 export { pullCommand } from './pull.js';
 export { diffCommand } from './diff.js';
+export { importCommand } from './import.js';
 //# sourceMappingURL=index.d.ts.map

package/src/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/src/commands/init.d.ts

@@ -1,8 +1,13 @@
 import { type CliServices } from '../services.js';
 import type { InitOptions } from '../types.js';
+import { type AIToolTarget } from '../utils/ai-tools-detector.js';
 /**
  * Initialize PromptScript in the current directory.
  * Creates configuration file and initial project structure.
  */
 export declare function initCommand(options: InitOptions, services?: CliServices): Promise<void>;
+/**
+ * Format target name for display using the formatter's description.
+ */
+export declare function formatTargetName(target: AIToolTarget): string;
 //# sourceMappingURL=init.d.ts.map

package/src/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAmBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAyD/C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyJf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAmBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AA+CvC;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA6Kf;AA8SD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAM7D"}

package/src/commands/registry/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/init.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAM5E;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyFf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAO5E;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAiGf"}

package/src/commands/serve.d.ts

@@ -0,0 +1,9 @@
+interface ServeOptions {
+    port?: string;
+    host?: string;
+    readOnly?: boolean;
+    corsOrigin?: string;
+}
+export declare function serveCommand(options: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/src/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/serve.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

package/src/utils/ai-tools-detector.d.ts

@@ -1,8 +1,8 @@
 import { type CliServices } from '../services.js';
 /**
- * Supported AI tool targets.
+ * AI tool target identifier — corresponds to a registered formatter name.
  */
-export type AIToolTarget = 'github' | 'claude' | 'cursor' | 'antigravity' | 'factory' | 'opencode' | 'gemini';
+export type AIToolTarget = string;
 /**
  * AI tool detection result.
  */
@@ -10,7 +10,7 @@ export interface AIToolsDetection {
     /** Detected AI tools with existing configuration */
     detected: AIToolTarget[];
     /** Details about detected files */
-    details: Record<AIToolTarget, string[]>;
+    details: Record<string, string[]>;
     /** Files that exist but were NOT generated by PromptScript (candidates for migration) */
     migrationCandidates: string[];
 }
@@ -19,12 +19,12 @@ export interface AIToolsDetection {
  */
 export declare function detectAITools(services?: CliServices): Promise<AIToolsDetection>;
 /**
- * Get all available targets.
+ * Get all available targets from the FormatterRegistry.
  */
 export declare function getAllTargets(): AIToolTarget[];
 /**
  * Get suggested targets based on detection.
- * If no tools detected, suggest all. Otherwise, suggest detected ones.
+ * If no tools detected, suggest common defaults. Otherwise, suggest detected ones.
  */
 export declare function getSuggestedTargets(detection: AIToolsDetection): AIToolTarget[];
 /**

package/src/utils/ai-tools-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools-detector.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/ai-tools-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAiGD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAgB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAiBzE"}
+{"version":3,"file":"ai-tools-detector.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/ai-tools-detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAkKD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAQ/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAiBzE"}

package/src/utils/resolve-target-directory.d.ts

@@ -0,0 +1,22 @@
+import type { FileSystem, PromptSystem } from '../services.js';
+export interface ResolveTargetDirectoryOptions {
+    cwd: string;
+    directoryArg?: string;
+    registryName: string;
+    nonInteractive: boolean;
+}
+interface ResolveServices {
+    fs: Pick<FileSystem, 'readdir'>;
+    prompts: Pick<PromptSystem, 'select'>;
+}
+/**
+ * Determine where to scaffold the registry.
+ *
+ * - Explicit directory arg: use it directly
+ * - Empty CWD + interactive: ask user "here or subdirectory?"
+ * - Empty CWD + non-interactive: scaffold in CWD
+ * - Non-empty CWD: create slugified subdirectory
+ */
+export declare function resolveTargetDirectory(options: ResolveTargetDirectoryOptions, services: ResolveServices): Promise<string>;
+export {};
+//# sourceMappingURL=resolve-target-directory.d.ts.map

package/src/utils/resolve-target-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target-directory.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/resolve-target-directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG/D,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/src/utils/slugify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert a string to a filesystem-safe slug.
+ *
+ * Lowercases, replaces non-alphanumeric characters with hyphens,
+ * deduplicates consecutive hyphens, and trims hyphens from edges.
+ */
+export declare function slugify(name: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/src/utils/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C"}

package/skills/migrate-to-promptscript/SKILL.md

@@ -1,228 +0,0 @@
----
-name: migrate-to-promptscript
-description: Migrate existing AI instruction files to PromptScript format. Use when converting CLAUDE.md, .cursorrules, copilot-instructions.md, AGENTS.md, or other AI instruction files into a unified .prs source.
----
-
-# Migrate to PromptScript
-
-## Overview
-
-This skill guides you through migrating existing AI instruction files
-to PromptScript format, creating a unified source of truth for all
-AI coding assistants.
-
-## Step 1: Discovery
-
-Search for existing instruction files using these patterns:
-
-Claude Code:
-
-- CLAUDE.md, claude.md, CLAUDE.local.md
-
-Cursor:
-
-- .cursorrules
-- .cursor/rules/\*.md
-- .cursor/rules/\*.mdc
-
-GitHub Copilot:
-
-- .github/copilot-instructions.md
-- .github/instructions/\*.md
-
-Factory AI:
-
-- AGENTS.md
-- .factory/skills/\*/SKILL.md
-
-Other:
-
-- AI_INSTRUCTIONS.md
-- AI.md
-- .ai/instructions.md
-
-Use Glob tool to find these files.
-
-## Step 2: Read and Analyze
-
-For each discovered file:
-
-1. Read the full content using the Read tool
-2. Identify sections by headers (##, ###) and patterns
-3. Classify content type using the mapping table below
-4. Note any tool-specific content that may need special handling
-
-## Step 3: Content Mapping
-
-Map source content to PromptScript blocks:
-
-| Source Pattern                       | PromptScript Block |
-| ------------------------------------ | ------------------ |
-| You are, persona, identity, role     | @identity          |
-| Tech stack, languages, frameworks    | @context           |
-| Coding standards, conventions, rules | @standards         |
-| Don't, Never, restrictions           | @restrictions      |
-| Commands, shortcuts                  | @shortcuts         |
-| API docs, references, knowledge base | @knowledge         |
-| Parameters, config values            | @params            |
-| File patterns, globs, applyTo        | @guards            |
-| Skills, capabilities                 | @skills            |
-| Agents, subagents                    | @agents            |
-| Local-only settings                  | @local             |
-
-## Step 4: Generate PromptScript
-
-### Required: @meta block
-
-Every PromptScript file needs metadata with id and syntax fields.
-
-### Identity (persona)
-
-Convert persona descriptions to @identity block with triple-quote string.
-
-### Context (project info)
-
-Convert tech stack to @context block with structured properties
-like project, languages, frameworks.
-
-### Standards (conventions)
-
-Convert coding standards to @standards block organized by category:
-code, naming, commits, etc.
-
-### Restrictions (don'ts)
-
-Convert restrictions to @restrictions block using dash prefix for each item.
-
-### Shortcuts (commands)
-
-Convert custom commands to @shortcuts block. Simple shortcuts use
-key-value format. Complex shortcuts use object format with
-prompt, description, and content fields.
-
-### Knowledge (references)
-
-Convert API docs and reference material to @knowledge block
-using triple-quote string for rich content.
-
-### Guards (file patterns)
-
-Convert file-specific rules to @guards block with globs array
-specifying file patterns.
-
-### Params (configuration)
-
-Convert configuration parameters to @params block with type annotations:
-range(), enum(), boolean.
-
-### Skills (capabilities)
-
-Convert skill definitions to @skills block with description,
-trigger, and content fields.
-
-### Agents (subagents)
-
-Convert agent definitions to @agents block with description,
-tools, model, and content fields.
-
-## Step 5: File Organization
-
-Simple Projects - single file structure:
-
-- .promptscript/project.prs
-- promptscript.yaml
-
-Complex Projects - modular file structure:
-
-- .promptscript/project.prs (main with @use imports)
-- .promptscript/context.prs
-- .promptscript/standards.prs
-- .promptscript/restrictions.prs
-- .promptscript/commands.prs
-- promptscript.yaml
-
-## Step 6: Configuration
-
-Create promptscript.yaml with:
-
-- version: '1'
-- project.id
-- input.entry pointing to main .prs file
-- targets for github, claude, cursor, factory, etc.
-
-## Step 7: Validation
-
-After generating PromptScript files:
-
-1. Validate syntax: prs validate
-2. Test compilation: prs compile --dry-run
-3. Compare output with original files
-4. Iterate if content is missing or incorrect
-
-## Common Patterns
-
-### Merging Multiple Sources
-
-When instructions exist in multiple files:
-
-1. Identity: Take from most detailed source
-2. Standards: Merge all, deduplicate
-3. Restrictions: Combine all (union)
-4. Commands: Merge, resolve conflicts
-
-### Tool-Specific Content
-
-Handle tool-specific content:
-
-- GitHub prompts: Use @shortcuts with prompt: true
-- Claude agents: Use @agents block
-- Cursor rules: Map to @standards
-- Local content: Use @local block
-
-### Preserving Formatting
-
-Use triple-quote multiline strings for:
-
-- Rich markdown content
-- Code examples
-- Complex instructions
-
-## Syntax Rules
-
-Quick reference for PromptScript syntax:
-
-- Strings: quoted or identifier
-- Multi-line: triple quotes
-- Arrays: [item1, item2] or - item prefix
-- Objects: { key: value }
-- Comments: # comment
-- Required @meta fields: id, syntax
-
-## Quality Checklist
-
-Before completing migration:
-
-- @meta block has id and syntax
-- Identity is clear and specific
-- Standards are organized by category
-- Restrictions use dash prefix (-)
-- Shortcuts work in target tools
-- prs validate passes
-- prs compile produces correct output
-- No duplicate content across blocks
-
-## Troubleshooting
-
-### Missing @meta Error
-
-Add required metadata block at the start.
-
-### Multiline String in Object Error
-
-Assign multiline strings to named keys, don't leave them loose
-inside objects.
-
-### Content Not Appearing in Output
-
-Check block names match expected patterns and
-verify syntax with prs validate --verbose.