Overview

This is a test fixture designed to trigger validation when the directory name does not match the skill name. It ensures repository hygiene by catching inconsistencies between folder names and the declared skill identity. The mismatch is intentional to verify accurate error reporting.

How This Skill Works

During validation, the system compares the folder name (name-directory-mismatch) to the skill's declared name (different-name) from SKILL.md. When they differ, the validator should flag an error, demonstrating how misnaming is surfaced to developers.

When to Use It

• When validating CI checks for naming consistency across all skills.
• When onboarding new skills to ensure directory and name alignment.
• When refactoring a skill and directory names diverge.
• When auditing a repository for naming convention adherence.
• When debugging a failure caused by mismatched skill metadata and folder structure.

Quick Start

1. Step 1: Create a folder named name-directory-mismatch and a SKILL.md with name: different-name.
2. Step 2: Ensure the SKILL.md description matches the intended skill.
3. Step 3: Run the skill validator to observe a mismatch error and fix accordingly.

Best Practices

• Enforce a strict rule that directory name equals skill name.
• Integrate a linter to catch mismatches in CI.
• Document the expected naming convention in CONTRIBUTING.md.
• Create mismatch tests to ensure validators fail loudly.
• Update both name and directory together when renaming a skill.

Example Use Cases

• Directory 'name-directory-mismatch' has skill name 'different-name' in SKILL.md.
• A skill renamed but not its folder, triggering a mismatch.
• New skills added with inconsistent naming conventions.
• A repository cleanup uncovers multiple name-dir mismatches.
• CI reports a mismatch error during skill validation runs.

Frequently Asked Questions