single-source-validator

Detect duplicated Bash commands and skill paths across agent and process documents.

1|1|Updated Jun 28, 2025
One-click install
npx skills add https://github.com/DarkMonkDev/WitchCityRope --skill single-source-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: single-source-validator
Source: https://github.com/DarkMonkDev/WitchCityRope/tree/main/.claude/skills/single-source-validator
Command: npx skills add https://github.com/DarkMonkDev/WitchCityRope --skill single-source-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, grep, find, sed, ls, and includes scripts (resource) components.

What problem does it solve?

Duplicated automation procedures across agent definitions, lessons learned, and process documents create confusion, maintenance nightmares, and lead to agents ignoring documentation due to conflicting information.

Core Features & Use Cases

  • Duplication Detection: Scans agent definitions, lessons learned, and process docs for duplicated bash commands, step-by-step procedures, and hardcoded skill paths.
  • Blocking Authority: Acts as a critical enforcement mechanism, blocking workflow completion (e.g., Phase 5 finalization) if any duplication violations are found.
  • Proper Reference Guidance: Promotes referencing Skills as the only source of automation, ensuring all other documentation points to the executable truth.
  • Use Case: After creating a new skill like container-restart, run this Skill to ensure its automation is exclusively defined within the skill itself and only referenced by other documents, preventing future confusion.

Quick Start

Validate the 'container-restart' skill for any duplication across documentation.

Frequently Asked Questions about single-source-validator

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

FAQPage Schema
How do I prevent documentation duplication across agent definitions and process docs?

Documentation duplication occurs when bash commands, step-by-step procedures, and skill paths are repeated across agent definitions, lessons learned, and process documents. This Skill detects such duplication by scanning these sources and identifies exact bash commands, procedures, and hardcoded skill paths that should exist only within the Skill itself, with other documents referencing it instead.

Can I enforce a single source of truth for automation procedures?

Yes. This Skill acts as a blocking enforcement mechanism during workflow completion (such as Phase 5 finalization), preventing advancement if duplication violations are found. It promotes referencing Skills as the only source of automation, ensuring all other documentation points to the executable truth rather than repeating procedures.

When should I run validation to catch duplicated automation?

Run this Skill after creating new skills, before Phase 5 finalization, when updating agent definitions or lessons learned, and during monthly audits. It scans for exact bash commands, step-by-step procedures, hardcoded skill paths, and procedural references that duplicate skills across your documentation ecosystem.

What happens if duplication is detected in my skill documentation?

The Skill reports violations and blocks workflow completion, preventing downstream processes from proceeding. This enforcement ensures you resolve conflicts and consolidate procedures into the Skill definition before continuing, eliminating agent confusion caused by conflicting information.

How does this approach differ from manual documentation reviews?

Automated scanning detects exact bash commands, procedures, and skill path duplications systematically across multiple document sources—agent definitions, lessons learned, and process docs—faster and more consistently than manual review, with blocking enforcement that prevents violations from reaching production workflows.

Do I need special tools or dependencies to validate duplicated automation?

This Skill uses standard bash utilities—grep, find, sed, and ls—to scan and identify duplication patterns. These are standard shell tools present on most systems, requiring no additional installations or specialized platforms beyond a bash environment.