file-placement

Validate Markdown and shell script placement against repository directory conventions.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/AINative-Studio/telemetry-agent --skill file-placement-ainative-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-placement
Source: https://github.com/AINative-Studio/telemetry-agent/tree/main/.ainative/skills/file-placement
Command: npx skills add https://github.com/AINative-Studio/telemetry-agent --skill file-placement-ainative-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces ZERO TOLERANCE file placement rules for documentation and scripts. It prevents misplacements that lead to project confusion, clutter, and maintenance overhead by ensuring documents live in dedicated folders and scripts are organized in their own scripts directory.

Core Features & Use Cases

  • Enforces root-placement restrictions for Markdown and shell script files according to established conventions.
  • Guides maintainers to organize content in designated directories (docs/, scripts/, references/, assets/) and to avoid ad hoc root files.
  • Use Case: When adding a new guide or utility script, this Skill validates the target location and suggests corrections if needed.

Quick Start

Place a new document or script in its intended folder and ask the agent to validate its placement.

Frequently Asked Questions about file-placement

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

FAQPage Schema
How do I enforce strict file placement rules for Markdown docs and shell scripts in a repository?

To enforce file placement rules, validate directory locations against your repository's documented conventions. This ensures Markdown docs go in docs/ and shell scripts in scripts/, surfacing violations for correction to prevent clutter and maintenance overhead.

What is the best way to organize root-level project files and avoid ad hoc script or document misplacements?

The best way to organize root-level project files is to apply zero-tolerance placement validation. This guides maintainers to route documents to dedicated directories like docs/ and scripts/, eliminating ad hoc root files that cause project confusion.

How do I validate that new utility scripts and guides are placed in their designated folders?

You validate placement by checking the target directory against established repository guidelines. When adding a guide or utility script, the validation mechanism confirms the item lives in docs/ or scripts/ and suggests corrections if misplaced.

Can I use directory placement validation for references and assets as well as standard documentation?

Yes, directory placement validation supports references/ and assets/ as needed. It applies zero-tolerance rules to ensure all documentation and related files are organized in their designated folders, maintaining strict repository governance.

Why does my repository have documentation clutter and how do I prevent misplaced Markdown files?

Repository documentation clutter happens when files bypass established guidelines. Prevent misplaced Markdown files by enforcing zero-tolerance placement rules that validate every document's directory location against your documented conventions and surface violations.

Does file placement governance work for both shell scripts and Markdown documents simultaneously?

Yes, file placement governance works for both shell scripts and Markdown documents simultaneously. It enforces zero-tolerance rules across both file types, validating that scripts and docs reside in their respective designated directories.