configure

qship — interactive configurator

This skill is the bootstrap step for the qship plugin. The plugin ships templates; this skill collects the values that fill them in.

When to run

• First time you install the qship plugin — the SessionStart hook prints a prompt directing you here.
• Whenever you want to change a configured value — added a service, new Jira project key, opted into a previously-skipped integration (Alembic migrations, ngrok, Playwright). Re-running re-renders the whole catalog from the latest answers.

What it does, end-to-end

1. Loads previous answers from $CLAUDE_PLUGIN_ROOT/answers/last-run.json if present.
2. Asks the questionnaire (7 rounds, ~two dozen questions) plus a per-repo loop via the AskUserQuestion tool. Defaults pulled from $HOME, git config, $USER, and platform conventions wherever possible.
3. Writes the consolidated answers to $CLAUDE_PLUGIN_ROOT/answers/last-run.json.
4. Shells out to setup.sh --config <answers-file> to render templates via envsubst, write repos.json to the skill root, merge hooks into ~/.claude/settings.json, and touch the first-run marker.
5. Verifies the install via setup.sh --check and surfaces any missing external plugins to the user.
6. Prints a quickstart with example invocations.

Step-by-step

Step 1 — Load previous answers, if any

ANSWERS_FILE="$CLAUDE_PLUGIN_ROOT/answers/last-run.json"
mkdir -p "$(dirname "$ANSWERS_FILE")"
if [ -f "$ANSWERS_FILE" ]; then
  echo "[/qship:configure] Loaded previous answers from $ANSWERS_FILE."
fi

Use the values from $ANSWERS_FILE as the per-question default in the next step.

Step 2 — Auto-detect what you can

USER_HOME="${USER_HOME:-$HOME}"
SKILLS_ROOT="${SKILLS_ROOT:-$HOME/.claude/skills}"
LOCAL_DB_USER_DEFAULT="${LOCAL_DB_USER:-$USER}"
GH_HOST_DEFAULT="${GH_HOST:-github.com}"
DEFAULT_BRANCH_DEFAULT="${DEFAULT_BRANCH:-develop}"
PRIMARY_LANGUAGE_DEFAULT="${PRIMARY_LANGUAGE:-python}"
CODEBASE_ROOT_DEFAULT="${CODEBASE_ROOT:-$(git -C "$PWD" rev-parse --show-toplevel 2>/dev/null || echo "$HOME/work/your-monorepo")}"