FAQ & Troubleshooting¶

What is PromptScript?¶

PromptScript is a language and toolchain for standardizing AI coding instructions across enterprise organizations. You write .prs files once and compile them to native formats for 37 AI coding agents - GitHub Copilot, Claude Code, Cursor, Windsurf, Cline, and more.

How many AI tools are supported?¶

PromptScript currently compiles to 37 AI coding agents. See the full list in the formatter architecture guide or the ROADMAP.

How do I install PromptScript?¶

npm install -g @promptscript/cli

Or use npx without installing:

npx @promptscript/cli compile

Or use Docker:

docker run --rm -v $(pwd):/workspace ghcr.io/mrwogu/promptscript compile

See the Getting Started guide for details.

How does inheritance work?¶

PromptScript supports hierarchical inheritance with @inherit and @use directives:

• @inherit - Extend a base configuration (single inheritance)
• @use - Import and merge additional rule sets (multiple imports)

Sources can be local files (./base) or registry packages (@company/standards). See the Inheritance guide.

How do I set up a private registry?¶

A registry is just a Git repository with .prs files. Configure it in your project:

prs registry add company https://github.com/your-org/promptscript-registry.git

See the Registry guide for full setup instructions.

How do I integrate with CI/CD?¶

Add PromptScript to your pipeline:

prs compile --check   # Fail if outputs are out of date
prs validate --strict  # Fail on any validation warnings

See the CI/CD guide.

Common Errors¶

PS1001: File not found¶

The @inherit or @use target cannot be resolved. Check:

• The file path is correct relative to the current file
• The registry is configured if using @scope/package syntax
• Run prs registry list to verify configured registries

PS2001: Unknown directive¶

You used a directive that PromptScript doesn't recognize. Check the Language Reference for valid directives.

PS3001: Validation error¶

A validation rule failed. The error message includes details on what's wrong and how to fix it. Run with --verbose for more context.

Compiled output doesn't match expected format¶

Ensure you're using the latest version of @promptscript/cli. Formatter behavior can change between versions. Run:

prs --version
npm update -g @promptscript/cli

How do I contribute?¶

See CONTRIBUTING.md for guidelines. Ways to help:

1. Add support for new AI tools (formatters)
2. Report bugs and suggest features
3. Improve documentation
4. Share PromptScript with your team