skills-doctor

stars-end's avatarfrom stars-end

Validate that the current VM has the right `agent-skills` installed for the repo you’re working in.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026
[Developer Tools]

When & Why to Use This Skill

Skills-doctor is a specialized diagnostic tool designed to validate the environment of AI agents. It ensures that the necessary 'agent-skills' and dependencies are correctly installed on a Virtual Machine (VM) for specific repositories, preventing execution failures caused by missing or stale tools. By providing actionable feedback and suggested fixes, it streamlines the setup process for agentic workflows and maintains environment health.

Use Cases

  • Environment Readiness Check: Use skills-doctor to verify that a VM is properly configured with all required skills before deploying an AI agent to a specific repository like prime-radiant-ai or affordabot.
  • Troubleshooting Missing Dependencies: Quickly identify why an agent is failing by checking for missing required skills such as dx-doctor, lockfile-doctor, or railway-doctor.
  • Stale Environment Detection: Detect and resolve issues where the local skills directory (~/.agent/skills) has become outdated or out of sync with the repository's current requirements.
  • Automated Workspace Validation: Integrate the check script into developer onboarding or CI/CD pipelines to ensure every workspace meets the minimum skill stack requirements.
nameskills-doctor
descriptionValidate that the current VM has the right `agent-skills` installed for the repo you’re working in.

skills-doctor

Description

Validate that the current VM has the right agent-skills installed for the repo you’re working in.

This is a soft doctor: it reports issues and suggested fixes, but should not block work.

Use when:

  • Agents are missing required skills (dx-doctor, lockfile-doctor, railway-doctor, etc.)
  • You suspect ~/.agent/skills is stale on a VM
  • You want a quick “is my skills stack correct for this repo?” check

How it works

  • Picks a repo profile from skill-profiles/ based on your repo’s origin remote URL.
  • Checks that each required skill directory exists under ~/.agent/skills (or AGENT_SKILLS_DIR).
  • Prints a small actionable summary.

Usage

# From inside a repo (prime-radiant-ai, affordabot, llm-common)
~/.agent/skills/skills-doctor/check.sh

Optional overrides:

export AGENT_SKILLS_DIR="$HOME/.agent/skills"
export SKILLS_DOCTOR_PROFILE="prime-radiant-ai"   # or affordabot, llm-common
~/.agent/skills/skills-doctor/check.sh