atv-doctor

Diagnose ATV Starter Kit installations for health, version, and dependency compliance.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/valegrajales/agentic-retrieval-example --skill atv-doctor-valegrajales
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atv-doctor
Source: https://github.com/valegrajales/agentic-retrieval-example/tree/main/.github/skills/atv-doctor
Command: npx skills add https://github.com/valegrajales/agentic-retrieval-example --skill atv-doctor-valegrajales

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you diagnose and maintain the health of your ATV Starter Kit installations, ensuring that your project scaffold and marketplace plugins are functioning correctly and up-to-date.

Core Features & Use Cases

  • Installation Health Check: Identifies issues with install paths, versioning, file integrity, and hook validity.
  • Dependency Management: Checks for MCP prerequisites and optional dependencies.
  • Quick Report Generation: Outputs a detailed report on the installation's status.
  • Fix Mode: Provides an option to automatically fix certain issues, such as outdated marketplace plugins.

Quick Start

Run the atv doctor command to check the health of your ATV Starter Kit installation.

Frequently Asked Questions about atv-doctor

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

FAQPage Schema
How do I check the installation health of my ATV Starter Kit?

To check ATV Starter Kit installation health, run the `atv doctor` command to execute scripts that diagnose install paths, file integrity, hook validity, and version consistency. It generates a detailed status report identifying any configuration issues within your project scaffold.

What is the best way to diagnose version control and dependency compliance issues in an ATV installation?

Diagnosing version control and dependency compliance involves running the `atv doctor` command to check your ATV Starter Kit for MCP prerequisites and optional dependencies. The script outputs a detailed report highlighting any version inconsistencies or missing dependency requirements.

Can I automatically fix outdated marketplace plugins during an installation health check?

Yes, you can automatically fix outdated marketplace plugins by using the Fix Mode option within the `atv doctor` diagnostic script. This feature resolves versioning and file integrity issues to restore your ATV Starter Kit installation to optimal performance.

Why does my ATV Starter Kit report file integrity and hook validity errors?

File integrity and hook validity errors occur when your ATV Starter Kit installation has corrupted files or invalid configurations. Running the `atv doctor` health check script isolates these specific installation issues and verifies dependency compliance to help you identify the root cause.

Do I need any external dependencies to run an ATV installation health check?

No external dependencies are required to run the `atv doctor` script itself, but the command checks your ATV Starter Kit installation for necessary MCP prerequisites and optional dependencies to ensure full dependency compliance and optimal performance.

What does an ATV Starter Kit diagnostic report include?

An ATV Starter Kit diagnostic report includes the status of your installation health, version consistency, file integrity, hook validity, and dependency compliance. The `atv doctor` script generates this detailed output to help you maintain your project scaffold and marketplace plugins.