@promptscript/cli 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.1](https://github.com/mrwogu/promptscript/compare/v1.3.0...v1.3.1) (2026-03-13)
+
+
+### Bug Fixes
+
+* init config schema, migrate flow, and skill consolidation ([#100](https://github.com/mrwogu/promptscript/issues/100)) ([af6fb5f](https://github.com/mrwogu/promptscript/commit/af6fb5f2deb8984ba6545a68c6398a20b1d8ab85))
+
 ## [1.3.0](https://github.com/mrwogu/promptscript/compare/v1.2.0...v1.3.0) (2026-03-11)
 
 

package/index.js

@@ -1696,14 +1696,22 @@ async function initCommand(options, services = createDefaultServices()) {
     await fs4.writeFile(".promptscript/project.prs", projectPsContent, "utf-8");
     const installedSkillPaths = [];
     if (options.migrate) {
-      const skillName = "migrate-to-promptscript";
+      const skillName = "promptscript";
       const skillSource = resolve2(BUNDLED_SKILLS_DIR, skillName, "SKILL.md");
-      const skillDest = `.promptscript/skills/${skillName}`;
       try {
         const skillContent = readFileSync3(skillSource, "utf-8");
+        const skillDest = `.promptscript/skills/${skillName}`;
         await fs4.mkdir(skillDest, { recursive: true });
         await fs4.writeFile(`${skillDest}/SKILL.md`, skillContent, "utf-8");
         installedSkillPaths.push(`${skillDest}/SKILL.md`);
+        for (const target of config.targets) {
+          const targetSkillDir = getTargetSkillDir(target, skillName);
+          if (targetSkillDir) {
+            await fs4.mkdir(targetSkillDir.dir, { recursive: true });
+            await fs4.writeFile(targetSkillDir.path, skillContent, "utf-8");
+            installedSkillPaths.push(targetSkillDir.path);
+          }
+        }
       } catch {
         ConsoleOutput.warn(`Could not install migration skill from ${skillSource}`);
       }
@@ -1744,12 +1752,13 @@ async function initCommand(options, services = createDefaultServices()) {
     ConsoleOutput.newline();
     console.log("Next steps:");
     if (options.migrate && installedSkillPaths.length > 0) {
-      ConsoleOutput.muted("1. Run: prs compile");
-      ConsoleOutput.muted("2. Use the migration skill in your AI tool:");
-      ConsoleOutput.muted("   Claude Code / Factory AI: /migrate-to-promptscript");
-      ConsoleOutput.muted("   GitHub Copilot: @workspace /migrate-to-promptscript");
-      ConsoleOutput.muted("   Cursor: /migrate-to-promptscript");
-      ConsoleOutput.muted("3. Review generated .promptscript/project.prs");
+      ConsoleOutput.muted("1. Use the migration skill in your AI tool:");
+      const skillInvocations = getSkillInvocationHints(config.targets);
+      for (const hint of skillInvocations) {
+        ConsoleOutput.muted(`   ${hint}`);
+      }
+      ConsoleOutput.muted("2. Review generated .promptscript/project.prs");
+      ConsoleOutput.muted("3. Run: prs compile");
     } else {
       ConsoleOutput.muted("1. Edit .promptscript/project.prs to customize your AI instructions");
       ConsoleOutput.muted("2. Run: prs compile");
@@ -2017,11 +2026,39 @@ function formatTargetName(target) {
   };
   return names[target] ?? target;
 }
-function generateConfig(config) {
-  const lines = ["version: '1'", "", "project:", `  id: '${config.projectId}'`];
-  if (config.team) {
-    lines.push(`  team: '${config.team}'`);
+function getTargetSkillDir(target, skillName) {
+  const skillDirs = {
+    claude: { dotDir: ".claude", fileName: "SKILL.md" },
+    factory: { dotDir: ".factory", fileName: "SKILL.md" },
+    github: { dotDir: ".github", fileName: "SKILL.md" },
+    opencode: { dotDir: ".opencode", fileName: "SKILL.md" },
+    gemini: { dotDir: ".gemini", fileName: "skill.md" }
+  };
+  const config = skillDirs[target];
+  if (!config) return null;
+  const dir = `${config.dotDir}/skills/${skillName}`;
+  return { dir, path: `${dir}/${config.fileName}` };
+}
+function getSkillInvocationHints(targets) {
+  const hints = [];
+  const skillSupport = {
+    claude: "Claude Code: /promptscript",
+    factory: "Factory AI: /promptscript",
+    opencode: "OpenCode: /promptscript",
+    gemini: "Gemini CLI: /promptscript",
+    github: "GitHub Copilot: /promptscript"
+  };
+  for (const target of targets) {
+    const hint = skillSupport[target];
+    if (hint) {
+      hints.push(hint);
+    }
   }
+  return hints;
+}
+function generateConfig(config) {
+  const syntaxVersion = getPackageVersion(__dirname, "./package.json");
+  const lines = [`id: ${config.projectId}`, `syntax: "${syntaxVersion}"`];
   lines.push("");
   if (config.inherit) {
     lines.push(`inherit: '${config.inherit}'`);
@@ -2059,7 +2096,7 @@ function generateConfig(config) {
   for (const target of config.targets) {
     lines.push(`  - ${target}`);
   }
-  lines.push("", "validation:", "  rules:", "    empty-block: warn");
+  lines.push("", "validation:", "  rules:", "    empty-block: warning");
   lines.push("");
   if (config.prettierConfigPath) {
     lines.push("formatting:", "  prettier: true  # Auto-detected from project");
@@ -6607,6 +6644,16 @@ var FactoryFormatter = class extends MarkdownInstructionFormatter {
     lines.push("---");
     lines.push(`name: ${skillName}`);
     lines.push(`description: ${this.yamlString(factoryConfig.description)}`);
+    if (factoryConfig.userInvocable === false) {
+      lines.push("user-invocable: false");
+    }
+    if (factoryConfig.disableModelInvocation === true) {
+      lines.push("disable-model-invocation: true");
+    }
+    if (factoryConfig.allowedTools && factoryConfig.allowedTools.length > 0) {
+      const toolsArray = factoryConfig.allowedTools.map((t) => `"${t}"`).join(", ");
+      lines.push(`allowed-tools: [${toolsArray}]`);
+    }
     lines.push("---");
     lines.push("");
     if (factoryConfig.content) {
@@ -23050,6 +23097,21 @@ var Compiler = class _Compiler {
           while (queue.length > 0) {
             const additionalFile = queue.shift();
             this.logger.verbose(`  \u2192 ${additionalFile.path} (additional)`);
+            const existingAdditionalOwner = outputPathOwners.get(additionalFile.path);
+            if (existingAdditionalOwner) {
+              formatWarnings.push({
+                ruleId: "PS4001",
+                ruleName: "output-path-collision",
+                severity: "warning",
+                message: `Output path '${additionalFile.path}' is written by both '${existingAdditionalOwner}' and '${formatter.name}'. The latter will overwrite the former.`,
+                suggestion: `Configure distinct output paths for these formatters, or disable one of them.`
+              });
+              if (additionalFile.additionalFiles) {
+                queue.push(...additionalFile.additionalFiles);
+              }
+              continue;
+            }
+            outputPathOwners.set(additionalFile.path, formatter.name);
             outputs.set(additionalFile.path, addMarkerToOutput(additionalFile));
             if (additionalFile.additionalFiles) {
               queue.push(...additionalFile.additionalFiles);
@@ -24219,18 +24281,18 @@ async function checkCommand(_options) {
       process.exitCode = 1;
       return;
     }
-    if (!config.version) {
+    if (!config.syntax) {
       results.push({
-        name: "Schema version",
+        name: "Syntax version",
         status: "warning",
-        message: `Missing "version" field. Add version: '1' to config`
+        message: 'Missing "syntax" field. Add syntax: "<version>" to config'
       });
       hasWarnings = true;
     } else {
       results.push({
-        name: "Schema version",
+        name: "Syntax version",
         status: "ok",
-        message: `v${config.version}`
+        message: `v${config.syntax}`
       });
     }
     const entryPath = config.input?.entry ?? ".promptscript/project.prs";

package/package.json

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

package/skills/promptscript/SKILL.md

@@ -300,7 +300,9 @@ Requires an aliased @use:
 ## Configuration: promptscript.yaml
 
 ```
-version: '1'
+id: my-project
+syntax: "1.1.0"
+description: "My project description"
 input:
   entry: .promptscript/project.prs
   include: ['.promptscript/**/*.prs']
@@ -379,3 +381,79 @@ 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
+
+## Migrating Existing AI Instructions to PromptScript
+
+Use this workflow when converting existing AI instruction files (CLAUDE.md, .cursorrules, copilot-instructions.md, etc.) to PromptScript `.prs` format.
+
+### Step 1: Discovery
+
+Find all existing AI instruction files in the project:
+
+- `CLAUDE.md` (Claude Code)
+- `.github/copilot-instructions.md` (GitHub Copilot)
+- `.cursorrules` or `.cursor/rules/*.mdc` (Cursor)
+- `.agent/rules/*.md` (Antigravity)
+- `AGENTS.md` (Factory AI / Codex)
+- `.clinerules` (Cline)
+- `.roorules` (Roo Code)
+- `.windsurf/rules/*.md` (Windsurf)
+- Any other AI instruction files
+
+### Step 2: Read and Analyze
+
+Read each discovered file and identify:
+
+- Identity/persona instructions ("You are...")
+- Project context (tech stack, architecture)
+- Coding standards and conventions
+- Hard restrictions and rules
+- Command shortcuts or slash commands
+- Skill definitions
+- Agent/subagent definitions
+
+### Step 3: Content Mapping
+
+Map content from source files to PromptScript blocks:
+
+| 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`       |
+
+### Step 4: Generate PromptScript
+
+Create `.prs` files in `.promptscript/` directory using the mapped content. Start with `project.prs` containing `@meta` with project id and syntax version.
+
+### Step 5: File Organization
+
+Split content into logical files:
+
+- `project.prs` - entry point with `@meta`, `@inherit`, `@use`, `@identity`
+- `context.prs` - `@context` block
+- `standards.prs` - `@standards` block
+- `restrictions.prs` - `@restrictions` block
+- `commands.prs` - `@shortcuts` and `@knowledge` blocks
+
+Use `@use ./context`, `@use ./standards`, etc. in `project.prs` to compose them.
+
+### Step 6: Configuration
+
+Create or update `promptscript.yaml` with appropriate targets matching the original AI tools being used.
+
+### Step 7: Validation
+
+Run `prs validate --strict` to check syntax, then `prs compile` to generate output files. Compare compiled output with original files to verify content was preserved.
+
+### Migration Tips
+
+- Preserve the original intent and tone of instructions
+- Don't lose any rules or restrictions during mapping
+- Use `@knowledge` for large reference sections that don't fit other blocks
+- Back up original files before overwriting with compiled output

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;AAyD/C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwKf"}

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.