Skill helper scripts

Helper scripts

Utility scripts the skills shell out to. Source-of-truth for each is the file itself; the documented header (first 12 lines) appears here.

repo-slug.sh

#!/usr/bin/env bash
# repo-slug.sh — derive the petrova registry slug for the current repo.
#
# Resolution order:
#   1. Match git remote 'origin' URL against registry.yaml's url fields.
#   2. Fall back to git remote repo name as the slug candidate.
#   3. Fall back to cwd basename.
# Verified against registry.yaml at the end — must appear under a slug: key.
#
# Output (stdout): the slug.
# Exit codes:
#   0 — slug found and verified

Full source: skills/petrova-act/scripts/repo-slug.sh.

verb-help.sh

#!/usr/bin/env bash
# verb-help.sh — print the params schema + worked example for a verb.
#
# Usage: verb-help.sh <verb-name>
# Output (stdout): the verb's input schema params + example input as JSON.
# Exit codes:
#   0 — schema printed
#   2 — UNKNOWN_VERB

set -euo pipefail

PETROVA_HOME="${PETROVA_HOME:-$HOME/code/workspace/petrova-hq}"

Full source: skills/petrova-act/scripts/verb-help.sh.