skilly. Buy ad slot
All skills
Community / AGENT SKILL

setup

thinhkhuat/skill-concierge
0 installs 0 GitHub stars
0

Bootstrap or repair the skill-concierge engine from scratch. Use this skill when installing skill-concierge on a new machine, right after a plugin update, or when skill-concierge:doctor reports the engine venv is missing. Runs setup.sh to build the stable engine venv, start the Qdrant container, build the multilingual index, and apply the curated skill-budget overrides, then verifies the result with doctor.

BEFORE YOU INSTALL

Understand the trade-offs.

SECURITY REVIEW

Not yet assessed

Review the original instructions and requested permissions before installing.

No security review is available for this catalog entry yet.

SKILL QUALITY

Not yet assessed

How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.

No quality assessment is available for this catalog entry yet.

The full skill.

Original instructions from the publisher’s SKILL.md

# skill-concierge setup

First-time bootstrap (and post-update refresh) for the vendored skill-search engine.
`setup.sh` is idempotent — safe to re-run any time.

## Prerequisites

- **Python 3.10–3.12** on `PATH` (or set `SKILL_PYTHON=/path/to/python3.12`).
- **Docker / OrbStack** running (hosts the Qdrant vector store).

If either is missing, tell the user and stop — `setup.sh` cannot proceed without them.

## Steps

1. **Run the bootstrap** from the plugin root:

   ```bash
   bash "$CLAUDE_PLUGIN_ROOT/setup.sh"
   ```

   (When working from a git clone instead, `cd` into the repo and run `./setup.sh`.)
   It performs four idempotent steps: stable venv + deps → Qdrant container → build/refresh
   the index (discovers skills from BOTH Claude Code and Codex directories, ADR-0033), the
   actionability-gate corpus and the keep-off offer-suppression map (durable home, inert while
   the ledger window is thin — ADR-0054) → apply curated overrides to `~/.claude/settings.json`
   (backed up first; Claude Code only — a harmless no-op when run from Codex).

2. **De-duplicate** any prior user-scope MCP so only the bundled one runs:

   ```bash
   claude mcp remove skill-search -s user
   ```

3. **Restart Claude Code** so the MCP server and the settings overrides take effect.

4. **Verify** the install:

   ```bash
   python3 "$CLAUDE_PLUGIN_ROOT/scripts/doctor.py"
   ```

   Expect `status: OK`. In Claude Code, `/mcp` should list `skill-concierge:skill-search`
   as connected. If anything is degraded, hand off to the `skill-concierge:doctor` skill.

## When to re-run

- After **any plugin update** (`/plugin marketplace update` + reinstall) — refreshes the
  engine copy in the stable venv and rebuilds the index.
- When the Qdrant data volume or the venv was wiped.

## Notes

- The venv lives at `~/.claude/skill-concierge/venv` (outside the plugin cache, so it
  survives reinstalls — ADR-0004). Override with `SKILL_CONCIERGE_VENV`.
- `setup.sh` reads the embedder + Qdrant URL from `.mcp.json` so the built index can never
  diverge from the model the live MCP uses.