arthur-ai/setup-genai-dev
.claude/skills/setup-genai-dev/SKILL.md
Set up the GenAI Engine development environment. Use when starting work on the project for the first time, or when environment needs to be reset. Handles uv, PostgreSQL, migrations, and environment variables.
$ install --global
skillsauthnpx skillsauth add arthur-ai/arthur-engine setup-genai-devInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:47 PM1.8s1 file scanned
SKILL.md
- name:
- setup-genai-dev
- description:
- Set up the GenAI Engine development environment. Use when starting work on the project for the first time, or when environment needs to be reset. Handles uv, PostgreSQL, migrations, and environment variables.
- allowed-tools:
- Bash, Read, Task
Setup GenAI Engine Development Environment
Step 1 — GPT Key Gate
Use the Read tool to read ./genai-engine/.env.
Check that GENAI_ENGINE_OPENAI_GPT_NAMES_ENDPOINTS_KEYS is present and has a non-empty value (not just GENAI_ENGINE_OPENAI_GPT_NAMES_ENDPOINTS_KEYS= with nothing after the =).
If the value is missing or empty:
- STOP immediately. Do not proceed to Step 2.
- Tell the user: "Setup cannot continue. Please open
genai-engine/.envand setGENAI_ENGINE_OPENAI_GPT_NAMES_ENDPOINTS_KEYSusing the format:MODEL_NAME::ENDPOINT_URL::API_KEY(e.g.gpt-4o::https://api.openai.com/::sk-...). Run the skill again once the key is set."
Step 2 — Delegate Setup to Bash Sub-Agent
Only proceed here if Step 1 passed. Spawn a Task sub-agent with subagent_type="Bash" and the following self-contained prompt:
Run the following setup steps for the GenAI Engine development environment. Report success or failure for each step and stop immediately if any step fails.
Step 1 — Prerequisites check:
python3 --version && docker ps && uv --version
If any fail, report which tool is missing and stop.
Step 2 — Install dependencies:
cd genai-engine && uv sync --group dev --group linters
Step 3 — Start PostgreSQL:
cd genai-engine && docker compose up -d db && sleep 5 && docker compose ps
Step 4 — Run database migrations with all required env vars:
cd genai-engine && \
set -a && source .env && set +a && \
export POSTGRES_USER=postgres \
POSTGRES_PASSWORD=changeme_pg_password \
POSTGRES_URL=localhost \
POSTGRES_PORT=5432 \
POSTGRES_DB=arthur_genai_engine \
POSTGRES_USE_SSL=false \
PYTHONPATH="src:$PYTHONPATH" \
GENAI_ENGINE_SECRET_STORE_KEY="some_test_key" \
GENAI_ENGINE_ENVIRONMENT=local \
GENAI_ENGINE_ADMIN_KEY=changeme123 \
GENAI_ENGINE_ENABLE_PERSISTENCE=enabled \
ALLOW_ADMIN_KEY_GENERAL_ACCESS=enabled && \
uv run alembic upgrade head && uv run alembic current
Report the final migration revision that is current after running these steps.
Related Skills
arthur-ai/integrations/claude-code-skills/arthur-onboard/arthur-onboard-verify
tools
VerifiedTrustedCommunity
--- name: arthur-onboard-verify description: Arthur onboarding sub-skill — Step 7: Verify that traces are flowing from the instrumented application to Arthur Engine. Reads credentials from .arthur-engine.env. allowed-tools: Bash, Read --- # Arthur Onboard — Step 7: Verify Instrumentation ## Read State ```bash cat .arthur-engine.env 2>/dev/null || echo "(no state file)" ``` Parse `ARTHUR_ENGINE_URL`, `ARTHUR_API_KEY`, `ARTHUR_TASK_ID`. --- ## Tell the User to Run Their Application Show the
81SKILL.mdUpdated May 28, 2026
arthur-ai/integrations/claude-code-skills/arthur-onboard/arthur-onboard-task
tools
VerifiedTrustedCommunity
--- name: arthur-onboard-task description: Arthur onboarding sub-skill — Step 3: Set up an Arthur Task (create or select). Reads/writes .arthur-engine.env. allowed-tools: Bash, Read, Write, Edit --- # Arthur Onboard — Step 3: Set Up Arthur Task **Goal:** Establish `ARTHUR_TASK_ID` in `.arthur-engine.env`. ## Read State ```bash cat .arthur-engine.env 2>/dev/null || echo "(no state file)" ``` Parse `ARTHUR_ENGINE_URL`, `ARTHUR_API_KEY`, and `ARTHUR_TASK_ID` from the output. **State write hel
81SKILL.mdUpdated May 28, 2026
arthur-ai/integrations/claude-code-skills/arthur-onboard/arthur-onboard-prompts
tools
VerifiedTrustedCommunity
--- name: arthur-onboard-prompts description: Arthur onboarding sub-skill — Step 6: Extract prompts from the target repository and register them with Arthur Engine. Reads credentials from .arthur-engine.env. allowed-tools: Bash, Read, Task --- # Arthur Onboard — Step 6: Extract & Register Prompts ## Read State ```bash cat .arthur-engine.env 2>/dev/null || echo "(no state file)" ``` Parse `ARTHUR_ENGINE_URL`, `ARTHUR_API_KEY`, `ARTHUR_TASK_ID`. --- ## Extract Prompts via Sub-agent Delegate
81SKILL.mdUpdated May 28, 2026
arthur-ai/arthur-onboard-platform
development
VerifiedTrustedCommunity
Onboard an agentic application to the Arthur SaaS Platform (platform.arthur.ai). Guides through authentication, workspace selection, engine deployment, model creation, code instrumentation, trace verification, and eval configuration.
81SKILL.mdUpdated May 28, 2026