Agent Skills
Installable Claude Code skills that set up self-hosted answerLoops and connect an agent to a running workspace.
answerLoops ships two Claude Code skills
directly in this repository, under skills/. A skill is a SKILL.md file —
Claude Code reads it and follows the instructions inside, so installing one
gives an agent a repeatable, reviewed procedure instead of it improvising the
setup or API calls from scratch each time. The easiest way to install either
one is the answerloops CLI, the bin of the
@answerloops/agent-sdk
npm package:
npx @answerloops/agent-sdk skills answerloops-setup answerloops-operateThat writes both into .claude/skills/. Install just one by naming it alone.
Both skills are plain files in a public repo — read them before installing if you want to know exactly what they do. Nothing here runs implicitly; a skill only acts when you ask your agent to use it.
answerloops-setup
Installs a self-hosted instance. The mechanical work — prerequisite checks,
cloning, .env scaffolding, starting the published image via
docker compose -f docker-compose.ghcr.yml up -d, polling /api/health
until it's actually up — is done by the same CLI:
npx @answerloops/agent-sdk setupIt stops and hands back to you for anything external — OAuth app creation,
AI provider keys. It never invents a credential: AUTH_SECRET and
ENCRYPTION_KEY are generated with real randomness in-process, and anything
else required (DATABASE_URL, AUTH_URL, AUTH_GOOGLE_ID,
AUTH_GOOGLE_SECRET) it reports as missing rather than guessing at.
Installing the skill (answerloops-setup, above) gives an agent the
judgment layer around this — collecting those real values from you in
conversation and re-running the command — rather than you running it solo
and hand-editing .env yourself. Either works; the skill just makes it
conversational.
answerloops-operate
Connects an agent to a running workspace — hosted or self-hosted — via the MCP server: search the knowledge base, read the FAQ, list and open tickets, generate grounded answers. Same pipeline every other channel uses, same per-key scopes and org isolation.
Mint a scoped API key (Settings → API Keys in your workspace) and ask your agent to connect it — the skill walks the rest.
Which one do I need?
| You want to... | Skill |
|---|---|
| Stand up your own instance | answerloops-setup |
| Point an agent at an instance that's already running (yours or hosted) | answerloops-operate |
| Both — self-host, then use it | Install both; run setup first |
Both are Claude Code skills today. Support for other agent CLIs/IDEs is tracked as a future expansion, not yet available.