libsync-diagnostics-and-tooling

Run Python diagnostic scripts to query libsync database states and logs.

4|Updated Aug 15, 2025
One-click install
npx skills add https://github.com/arthursoares/libsync --skill libsync-diagnostics-and-tooling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: libsync-diagnostics-and-tooling
Source: https://github.com/arthursoares/libsync/tree/main/.claude/skills/libsync-diagnostics-and-tooling
Command: npx skills add https://github.com/arthursoares/libsync --skill libsync-diagnostics-and-tooling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows for diagnostic measurements and troubleshooting within the libsync ecosystem, providing read-only scripts and documentation to understand and fix issues without manual observation.

Core Features & Use Cases

  • Diagnostics and Health Checks: Offers various scripts to check config settings, deduplication logic, download statuses, and other health-related metrics.
  • Scriptable Tools: Provides seven runnable tools for specific diagnostic tasks, such as redacting config secrets and probing WebSocket data.
  • Documentation: Includes detailed guides on each script's purpose and usage.
  • Use Case: If you encounter a problem with libsync, such as albums not downloading or discrepancies between the database and disk, this skill provides tools to investigate and resolve these issues.

Quick Start

To start a diagnostics session, run 'scripts/env-doctor.sh' from within the skill directory.

Frequently Asked Questions about libsync-diagnostics-and-tooling

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

FAQPage Schema
How do I troubleshoot libsync application health issues like albums not downloading?

To troubleshoot libsync application health issues like failed album downloads, you can run read-only diagnostic scripts to query database states, check download statuses, and identify discrepancies between the database and disk.

How do I check database states and deduplication logic in libsync?

You can check database states and deduplication logic in libsync by executing Python diagnostic scripts that query and report on application logs and internal health metrics without requiring manual observation.

Do I need Python to run libsync diagnostic tools?

Yes, you need Python installed in your environment to run the scriptable libsync diagnostic tools, which you can initiate by executing the env-doctor.sh shell script from the skill directory.

Can I use Python scripts to redact config secrets during application health checks?

Yes, you can use Python scripts to redact config secrets during application health checks, as the diagnostic toolkit includes specific runnable tools for securely probing WebSocket data and verifying configuration settings.

What is the best way to investigate discrepancies between the libsync database and disk?

The best way to investigate discrepancies between the libsync database and disk is to use dedicated troubleshooting scripts that measure application health and report on download statuses to pinpoint sync failures.