# PromptSama

> Static field guides and installable Codex skills for model-specific image and video prompting.

Canonical site: https://www.promptsama.ai/

When an agent is pointed to PromptSama, read `https://www.promptsama.ai/skills.json` first. It is the canonical machine-readable catalog. For repository behavior and safe installation, read `https://www.promptsama.ai/AGENTS.md`.

## Agent entry points

- `https://www.promptsama.ai/skills.json` — machine-readable skill names, descriptions, triggers, entrypoints, archives, and install commands.
- `https://www.promptsama.ai/AGENTS.md` — discovery, use-in-place, and installation instructions.
- `https://www.promptsama.ai/Skills/README.md` — human-readable catalog and quick start.
- `https://www.promptsama.ai/scripts/install-skills.sh` — safe installer that refuses to overwrite existing skills.

## Skills

- `seedance-2-5-reference-prompts`
  - Entrypoint: `/Skills/seedance-2-5-reference-prompts/SKILL.md`
  - Archive: `/Skills/seedance-2-5-reference-prompts.zip`
  - Use for Seedance 2.5 OMNI references, staged continuity, editing, extension, storyboards, blockouts, and audio syntax.

- `minimax-h3-reference-prompts`
  - Entrypoint: `/Skills/minimax-h3-reference-prompts/SKILL.md`
  - Archive: `/Skills/minimax-h3-reference-prompts.zip`
  - Use for MiniMax H3 compact Image1/Video1/Audio1 references, shot timing, dialogue, voice and motion transfer, native sound, and editing.

## Install from a local clone

```sh
./scripts/install-skills.sh --list
./scripts/install-skills.sh seedance-2-5-reference-prompts
./scripts/install-skills.sh minimax-h3-reference-prompts
./scripts/install-skills.sh all
```

## Install from the hosted site

When the user asks to install PromptSama skills from the website:

1. Read `https://www.promptsama.ai/skills.json` and its `hosted_install` instructions.
2. Resolve each selected skill's `archive` path relative to that manifest URL.
3. Download and extract the ZIP; it must contain one complete skill folder with `SKILL.md` and its bundled files.
4. Copy the complete folder to `$CODEX_HOME/skills`, or `~/.codex/skills` when `CODEX_HOME` is unset.
5. Refuse to overwrite an existing skill directory and report installed or skipped skills.
6. Tell the user the installed skills will be available on their next turn.

To use a skill without installation, read its complete entrypoint and every reference file required by its instructions.