Skip to content

Shared Resources

Place files in .promptscript/shared/ to make them available to every skill during compilation. Shared resources are included in each skill's output with the @shared/ prefix.

Directory Structure

my-project/
├── .promptscript/
│   ├── project.prs
│   ├── skills/
│   │   ├── review/
│   │   │   └── SKILL.md
│   │   └── security/
│   │       └── SKILL.md
│   └── shared/                  # Shared across all skills
│       ├── templates/
│       │   └── report.md
│       └── data/
│           └── config.json
└── promptscript.yaml

How It Works

When PromptScript compiles skills, it:

  1. Discovers files in .promptscript/shared/
  2. Adds them to every skill's resources with an @shared/ prefix
  3. Copies them to each compilation target alongside skill-specific files

A skill at .promptscript/skills/review/ with its own checklist.md and shared resources gets:

.claude/skills/review/
├── SKILL.md
├── checklist.md              # Skill-specific resource
├── @shared/templates/report.md   # From shared/
└── @shared/data/config.json      # From shared/

Use Cases

  • Report templates shared across review, security, and audit skills
  • Configuration files (linting rules, coding standards) used by multiple skills
  • Data files (CSV databases, JSON schemas) referenced by several skills
  • Scripts (Python tools, shell scripts) invoked by different skills

Security Limits

Shared resources follow the same security limits as skill resources:

  • Files larger than 1 MB are skipped
  • Total resources per skill cannot exceed 10 MB
  • Maximum 100 resource files per skill (including shared)
  • Symlinks are ignored
  • Binary files are excluded
  • System files (.env, .gitignore, node_modules/) are skipped

See Also