broken-layout

Detect misplaced README.md and nested reference files in skill folders.

3|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/ribeirogab/agent-skills --skill broken-layout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: broken-layout
Source: https://github.com/ribeirogab/agent-skills/tree/main/evals/skill-improver/fixtures/broken-layout
Command: npx skills add https://github.com/ribeirogab/agent-skills --skill broken-layout

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It detects structural violations within skill folders to ensure adherence to authoring standards and improve validation accuracy.

Core Features & Use Cases

  • Structural Validation: Finds presence of misplaced files like README.md directly inside skill folders, which violate editing rules.
  • Checklist Enforcement: Ensures reference files are within the correct depth and path formatting standards are followed.
  • Use Case: Automatically audits a skill directory to identify misplaced reference files and improper documentation placement, facilitating compliance and consistency.

Quick Start

Run the auditor on the skill directory to identify structural violations and improve folder organization.

Frequently Asked Questions about broken-layout

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

FAQPage Schema
How do I validate skill folder structure for directory depth and naming conventions?

To validate skill folder structure, run an auditor that detects misplaced files like README.md directly inside skill folders and checks for nested reference files located two levels deep. This enforces authoring standards for proper validation and discoverability.

What structural violations cause skill directory audit failures?

Skill directory audit failures are caused by structural violations including unallowed documentation files placed directly inside skill folders and reference files nested beyond the correct directory depth, violating standard authoring guidelines and path formatting rules.

How does directory structure validation enforce authoring standards?

Directory structure validation enforces authoring standards by automatically auditing skill folders to identify misplaced reference files and improper documentation placement. It checks directory depth and naming conventions to maintain repository consistency and compliance.

Can I audit misplaced reference files in skill repositories automatically?

Yes, you can automatically audit skill repositories to identify misplaced reference files and enforce correct folder organization. The auditor checks for reference files at incorrect depths and unallowed documentation files inside skill folders.

Why does my skill folder validation fail when I add a README.md file?

Skill folder validation fails when adding a README.md file because unallowed documentation files placed directly inside skill folders violate authoring guidelines. The auditor detects these structural violations to ensure proper directory formatting and discoverability.