SSH Info

Return connection details and targeted status checks for a server or cluster.

This skill is for operator lookup and focused inspection. It is not a full deploy skill and it should not invent a broad diagnostic sweep when the user asked for one narrow check.

Default Marker

Start with a stable first progress update such as:

Using ssh-info to resolve the client overlay, then run only the requested server checks.

Use This For

• "ssh info", "how do I connect", "what host is this on"
• "server status", "what containers are running", "check prod"
• one-shot log, health, or container checks
• quick DB access patterns and container topology lookup

Do Not Use This For

• deployment workflows or rollback execution
• code changes inside the target repo
• full environment bring-up or local-dev bootstrap

Use deploy for operational changes and dev-sanity for local ecosystem health checks.

Client Overlay

This skill resolves configuration from the skillbox client overlay at skillbox-config/clients/{client}/overlay.yaml. The supported contract is client.context.deploy; there is no legacy shell-config fallback.

The overlay's deploy section holds:

• droplet_ssh: SSH target (e.g. root@1.2.3.4)
• droplet_ip: server IP
• ssh_key: path to SSH key
• services: map of service entries, each with:
  • label, compose_service, health_url, internal_port
  • deploy_root, compose_file, domain, env_file

See references/mode-template.md for the full key reference.

If no overlay matches, scripts/status.sh surfaces the shared legacy-transition message from _shared/scripts/resolve_context.py, then exits non-zero.

If you need to create a missing client overlay before proceeding:

python3 ~/.claude/skills/skill-issue/scripts/manage_overlays.py create --client-id {CLIENT_ID} --cwd "$PWD" --json

Then re-resolve config. Do not guess a host or a production URL.

Execution Policy

Run only what the user asked for.

1. Resolve the client overlay first.
2. Respect requested scope: connection info, containers, health, logs, DB, or full status.
3. If the request is vague, do the smallest useful baseline:
   • show connection target
   • show a short container summary
4. Do not restart services or run destructive DB commands. This skill is read-first.

Common Requests

Connection Info

Return:

• SSH target
• auth method notes from the client overlay
• relevant repo or deploy root hints, if the overlay defines them

Container Status

Run the bundled helper:

bash scripts/status.sh prod

The script resolves config from the overlay's deploy section via _shared/scripts/resolve_context.py, then either:

• runs locally on the server, or
• wraps commands in SSH when droplet_ssh is set

Local Health URLs

When the user wants the known URLs without a full sweep:

bash scripts/status.sh local

Full Status Sweep

Use this only when explicitly requested:

bash scripts/status.sh prod
bash scripts/status.sh local

Then summarize:

• which services are up
• which checks failed
• what to inspect next

Safe Query Patterns

Container List

docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

Logs

docker logs <container> --since 30m 2>&1 | tail -50

DB Query

docker exec <db-container> psql -U <user> -d <db> -c "SELECT ...;"

Prefer SELECT queries. Treat write queries as out of scope unless the user explicitly asks for them.

Safety

• Production-first caution: default to read-only inspection
• No destructive SQL
• No service restarts
• No deploy or rollback actions
• No guesses when the client overlay is missing or incomplete

Validation

Before shipping changes to this skill:

SKILLS_ROOT="/path/to/skills/root"
python3 "$SKILLS_ROOT/skill-issue/scripts/quick_validate.py" "$SKILLS_ROOT/ssh-info"
bash "$SKILLS_ROOT/ssh-info/scripts/status.sh" >/tmp/ssh-info.out 2>/tmp/ssh-info.err || true
head -n 2 /tmp/ssh-info.out /tmp/ssh-info.err

The helper should fail cleanly with usage or the shared legacy-transition message when no client overlay exists.