What happens if I have intentional 'bad' examples in my docs?

The analyzer is designed to skip content inside tags or code blocks marked with 'bad' in the info string to prevent false positives.

Which files does the analyzer check?

It scans agents, skills, and workflow files within your project directory to build a map of dependencies and semantic instructions.

Does this skill automatically fix the issues it finds?

No, because cross-file changes often involve architectural decisions, the skill provides detailed findings for human review rather than applying automatic fixes.

Why is tool-frontmatter consistency important?

Claude requires tools to be explicitly declared in the frontmatter to use them; if a tool is mentioned in a prompt but not declared, the agent will fail to execute it.

Cross-File Consistency Analyzer

Name: Cross-File Consistency Analyzer
Author: agent-sh

byagent-sh

•

Developer Tools

Validates semantic consistency across agents, tools, and workflows to identify discrepancies that single-file analysis misses.

The Cross-File Consistency Analyzer is a specialized diagnostic tool designed to maintain the structural integrity of complex agentic systems. It moves beyond basic linting by performing holistic checks across multiple files, ensuring that tools used in prompt bodies are correctly declared in frontmatter, agent references in workflows are valid, and instructions remain consistent without contradictions. This skill is essential for developers managing multi-agent plugins, as it prevents maintenance debt by flagging duplicate rules and identifying orphaned agents that are no longer part of active workflows.

Key Features

011 GitHub stars

02Contradiction detection to highlight conflicting 'ALWAYS' and 'NEVER' constraints

03Instruction de-duplication to flag redundant rules across multiple files

04Orphaned agent identification to find files not referenced by any workflow

05Workflow integrity checks to identify missing or non-existent agent references

06Cross-file tool validation to ensure all used tools are declared in frontmatter

Use Cases

01Refactoring redundant instructions into global configuration files

02Debugging tool execution failures caused by missing metadata declarations

03Auditing large-scale multi-agent plugins for structural and semantic errors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agent-sh/enhance enhance-cross-file

For use in Claude.ai and ChatGPT

Download Skill