subagent-check

Validate Claude Code subagents against best practices for YAML, prompts, and tools.

28|1|Updated Aug 30, 2025
One-click install
npx skills add https://github.com/outfitter-dev/agents --skill subagent-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-check
Source: https://github.com/outfitter-dev/agents/tree/main/agent-kit/skills/subagent-check
Command: npx skills add https://github.com/outfitter-dev/agents --skill subagent-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill validates Claude Code subagents against best practices, including YAML frontmatter, system prompts, and tool configuration.

Core Features & Use Cases

  • YAML frontmatter validation: Required fields and syntax checks.
  • System prompt quality: Clear role, process, outputs, constraints.
  • Tool & model checks: Validate tools and model settings.

Quick Start

Validate a subagent directory to ensure it adheres to the Agent Skills spec.

Frequently Asked Questions about subagent-check

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

FAQPage Schema
How do I validate a Claude Code subagent's YAML syntax and structure?

YAML validation checks required frontmatter fields, syntax correctness, and naming conventions. Run the subagent-check Skill to audit YAML frontmatter against the Agent Skills spec and receive improvement suggestions for structural issues.

What makes a system prompt effective for a subagent?

An effective system prompt defines the agent's role, processing steps, expected outputs, and constraints clearly. The Skill evaluates prompt quality and identifies gaps in role definition, process clarity, and constraint specification.

Can I validate tool configuration in my subagent before deployment?

Yes. The Skill validates tools and model settings within your subagent configuration, catching misalignments and configuration errors during validation, code review, or pre-commit checks.

How do I integrate subagent validation into my development workflow?

Trigger validation with --check-agent or --validate-agent flags during pre-commit checks, code review, or on-demand validation to ensure your subagent meets best-practice standards before deployment.

What happens if my subagent fails validation checks?

The Skill provides specific improvement suggestions for each issue found—YAML syntax errors, naming convention violations, weak descriptions, or tool misconfigurations—and offers optional automated fixes.