Package Exports

@promptscript/cli
@promptscript/cli/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@promptscript/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Stop configuring AI tools manually. Start compiling.

One compiler. 37 AI coding agents. Zero manual syncing.

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, validation, and version control built in.

The Problem You Already Have

Maintaining .cursorrules, CLAUDE.md, .github/copilot-instructions.md separately?

❌ 50 repos x 37 AI tools = 1,900 files to keep in sync
❌ Security policy update? Manual changes across every repo
❌ Switching AI tools? Rewrite everything from scratch
❌ No inheritance, no validation, no audit trail

The Fix: Prompt-as-Code

Write once  ──>  prs compile  ──>  .github/copilot-instructions.md
                                    CLAUDE.md
                                    .cursor/rules/*.mdc
                                    AGENTS.md
                                    GEMINI.md
                                    OPENCODE.md
                                    ... 31 more

✅ Single source of truth for all 37 agents
✅ Hierarchical inheritance - org, team, and project levels cascade like CSS
✅ Full validation catches errors before they reach your AI tools
✅ Version-pinned registries for reproducible builds

Quick Start

npm install -g @promptscript/cli

prs init          # auto-detects your tech stack
prs compile       # outputs to all configured AI tools

Three commands. Every AI tool configured.

Already have CLAUDE.md or .cursorrules?

prs import CLAUDE.md        # converts existing files to .prs
prs migrate                 # or migrate everything at once

Use Skills from Anywhere

Import skills directly from GitHub - no scripts, no downloads, no manual steps:

@use github.com/anthropics/skills/frontend-design.md@1.0.0
@use github.com/your-org/standards/security-scan.md
@use ./local-skills/code-review.md

One line per skill. Version-pinned. Lock-filed. Done.

Import entire skill directories at once:

@use github.com/your-org/skills/gitnexus
# Resolves all skills: exploring, debugging, refactoring, impact

What a .prs File Looks Like

@meta { id: "checkout-service" syntax: "1.0.0" }

@inherit @company/backend-security
@use @fragments/testing
@use ./skills/security-scan.md

@identity {
  """
  You are an expert Backend Engineer working on the Checkout Service.
  This service handles payments using hexagonal architecture.
  """
}

@shortcuts {
  "/review": "Security-focused code review"
  "/test": "Write unit tests with Vitest"
}

@skills {
  deploy: {
    description: "Deploy service to production"
    userInvocable: true
    allowedTools: ["Bash", "Read"]
  }
}

Run prs compile and get correctly formatted output for every AI tool your team uses.

Supported Targets

AI Tool	Output
GitHub Copilot	`.github/copilot-instructions.md`, agents, prompts
Claude Code	`CLAUDE.md`, `.claude/skills/*.md`
Cursor	`.cursor/rules/*.mdc`
Google Antigravity	`.agent/rules/*.md`
Factory AI	`AGENTS.md`, `.factory/skills/`, `.factory/commands/`
OpenCode	`OPENCODE.md`, `.opencode/commands/*.md`
Gemini CLI	`GEMINI.md`, `.gemini/commands/*.toml`

Plus 30 more: Windsurf, Cline, Roo Code, Codex, Continue, Augment, and others. See the full list.

Key Features

Feature	What it does
Inheritance	Org -> team -> project configs that cascade like CSS
Composition	Reuse fragments and skills with `@use`
Markdown imports	`@use` plain `.md` files and GitHub skills directly
Parameterized templates	`@inherit @stacks/node(port: 8080, db: "postgres")`
Skills	SKILL.md files with resource bundles and tool permissions
Multi-target compilation	One source, any number of AI tools
Watch mode	`prs compile -w` for instant recompilation
Overwrite protection	Never accidentally clobbers hand-written files
Validation	`prs validate --strict` catches errors before they ship
Registry support	Share configs via Git registries (private or public)
Migration	Import existing CLAUDE.md, .cursorrules with `prs import`

Commands

Command	Description
`prs init`	Initialize project with auto-detection
`prs compile`	Compile to all target formats
`prs compile -w`	Watch mode - recompile on changes
`prs compile --dry-run`	Preview without writing files
`prs validate`	Validate `.prs` files with detailed errors
`prs validate --fix`	Auto-fix syntax version mismatches
`prs import`	Import existing AI instruction files
`prs migrate`	Migrate all existing instructions at once
`prs skills add`	Add skills from GitHub or local paths
`prs skills list`	List installed skills
`prs diff`	Show diff between source and compiled output
`prs upgrade`	Upgrade `.prs` files to latest syntax version
`prs pull`	Pull updates from registry

Configuration

promptscript.yaml:

version: '1'
input:
  entry: '.promptscript/project.prs'
targets:
  - github
  - claude
  - cursor

Docker

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

Documentation

Getting Started - 5-minute quickstart
Language Reference - full syntax docs
Guides - inheritance, registry, migration, and more
Enterprise - scaling across organizations

License

MIT