# PromptSama agent guide

PromptSama contains installable Codex skills for model-specific image and video prompting.

## Discover skills

1. Read [`skills.json`](skills.json) for the machine-readable catalog.
2. Match the user's request against each skill's `description` and `triggers`.
3. Read the selected skill's complete `SKILL.md` before using it.
4. Follow every reference file that the selected `SKILL.md` requires for the task.

The human-readable catalog is [`Skills/README.md`](Skills/README.md). The hosted agent entry point is [`llms.txt`](llms.txt).

The canonical hosted catalog is `https://www.promptsama.ai/skills.json` and the hosted discovery guide is `https://www.promptsama.ai/llms.txt`.

## Use or install

- To use a skill without installing it, read it directly from `Skills/<skill-name>/SKILL.md` and follow it for the current task.
- Install only when the user asks to make a skill available to other Codex tasks.
- List available skills with `./scripts/install-skills.sh --list`.
- Install one skill with `./scripts/install-skills.sh <skill-name>`.
- Install both skills with `./scripts/install-skills.sh all`.
- Use `--dest <directory>` to target a non-default skill directory.

The installer copies the complete skill folder and refuses to overwrite an existing installation. Do not copy only `SKILL.md`; bundled `references/` and `agents/` files are part of the skill.

### Install from the hosted website

When the user provides the hosted PromptSama URL instead of a local clone, read `skills.json` from that origin. Follow its `hosted_install` instructions, resolve each selected `archive` path relative to the manifest URL, and install the extracted complete skill folder into the Codex skills directory. Never overwrite an existing skill directory. Report installed and skipped skills, and tell the user the new skills will be available on their next turn.

## Available skills

- `seedance-2-5-reference-prompts` — Dreamina Seedance 2.5 OMNI/reference mapping, staged narratives, editing, extension, storyboards, blockouts, audio syntax, and continuity checks.
- `minimax-h3-reference-prompts` — MiniMax H3 compact `Image1`/`Video1`/`Audio1` references, timed coverage, dialogue, voice and motion transfer, First/Last Frame, editing, and native sound.

Do not apply Seedance `@image1` syntax to MiniMax H3. H3 uses compact labels such as `Image1`, with no `@` prefix.