api-ops

Check Patcher API service health and diagnose Linux deployment failures.

27|1|Updated Feb 20, 2024
One-click install
npx skills add https://github.com/liquidz00/Patcher --skill api-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-ops
Source: https://github.com/liquidz00/Patcher/tree/main/.claude/skills/api-ops
Command: npx skills add https://github.com/liquidz00/Patcher --skill api-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you verify whether the Patcher API service is running correctly, identify broken systemd or cloudflared components, and diagnose the most common Linux deployment failures without making any changes.

Core Features & Use Cases

  • Read-only health checks: Inspect the API service, tunnel, timers, endpoints, database state, and disk usage to determine whether the deployment is healthy.
  • Failure triage: Recognize known issues such as missing KEYRING_BACKEND, SQLite locking, permission problems, restart loops, and cloudflared ingress mismatches.
  • Operations guidance: Translate systemd-based deployment details into concrete next steps and best-effort Docker troubleshooting advice when needed.

Quick Start

Ask the api-ops skill to check the Patcher API health and explain any failures it finds.

Frequently Asked Questions about api-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the health of my Patcher API service on Linux?

To check the health of your Patcher API service on Linux, perform a read-only status sweep that inspects the systemd service, cloudflared tunnel, timers, endpoints, SQLite database state, and disk usage to identify any deployment failures.

Why does my systemd service keep restarting with a missing KEYRING_BACKEND error?

A systemd service restart loop with a missing KEYRING_BACKEND error indicates a known deployment failure signature. You can diagnose this by inspecting the service logs and verifying the environment configuration to triage the permission or keyring issue.

How do I troubleshoot SQLite database locking issues in my API deployment?

To troubleshoot SQLite database locking issues in your API deployment, inspect the database state and service logs to identify locking conflicts. This helps determine if permission problems or concurrent access are causing the deployment failure.

Can I diagnose cloudflared tunnel connectivity problems without modifying my Linux host?

Yes, you can diagnose cloudflared tunnel connectivity problems without modifying your Linux host by running read-only health checks. This involves inspecting endpoint availability and identifying ingress mismatches in the tunnel configuration.

What is the best way to triage a Patcher API deployment failure?

The best way to triage a Patcher API deployment failure is to analyze systemd and cloudflared logs for known issues like restart loops, database locking, and missing environment variables, translating these into concrete operational next steps.

Does this API health check process require a deploy-token to function?

The API health check process requires awareness of deploy-token gating within the service layout. While the checks are read-only, understanding the token gating is necessary to accurately verify endpoint accessibility and service behavior.