Can this skill fix my workflow files automatically?

No, the Workflow Validator is strictly read-only. It identifies architectural issues and provides recommended fixes in JSON format, but it will never modify your source files.

Does it validate the actual logic inside my shell scripts?

It primarily checks if the scripts exist in the correct directory, are marked as executable, and are correctly referenced by the skill's operations.

Why shouldn't a Director skill have orchestration logic?

In this pattern, Directors are intended for simple pattern expansion. Keeping orchestration logic within the Manager Agent prevents state-management conflicts and maintains a clear separation of concerns.

What is the Manager-as-Agent principle?

It is an architectural pattern where the top-level orchestration is handled by a full Claude Agent with comprehensive tool access, while specific sub-tasks are delegated to specialized Skills.

Workflow Validator

Name: Workflow Validator
Author: fractary

$fractary$ byfractary

•

Security & Testing

Validates Claude agentic workflows to ensure compliance with architectural patterns and the Manager-as-Agent principle.

The Workflow Validator skill is a specialized auditing tool designed to maintain high standards for complex AI architectures. It automatically inspects Manager agents, Director skills, and specialist components to prevent common anti-patterns, such as Managers lacking critical tool access or Directors containing illegal orchestration logic. By executing automated validation scripts and providing structured JSON feedback, it ensures that your agentic workflows are robust, correctly routed, and follow established best practices for scalability and execution.

Key Features

01Verifies Manager-as-Agent architectural compliance

02Ensures correct command routing between agents and skills

03Validates script directory structures and execution permissions

04Inspects XML markup and frontmatter for schema completeness

052 GitHub stars

06Detects orchestration anti-patterns in Director skills

Use Cases

01Automated linting for AI-assisted development projects

02Pre-deployment auditing of complex multi-agent workflows

03Troubleshooting routing and permission issues in custom Claude plugins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins workflow-validator

For use in Claude.ai and ChatGPT

Download Skill