file-categorization

Categorize files into Command, Agent, Skill, Documentation, or Other types.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server --skill file-categorization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-categorization
Source: https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server/tree/main/docs/claude/skills/file-categorization
Command: npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server --skill file-categorization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the complex task of categorizing files within a repository, reducing manual effort and ensuring consistent organization. It intelligently identifies files as Commands, Agents, Skills, or Documentation, streamlining integration pipelines and validation processes.

Core Features & Use Cases

  • Multi-Phase Categorization: Uses filename patterns, YAML frontmatter, content structure, and keyword detection for accurate classification.
  • Automated Routing: Helps in automatically moving files to appropriate directories based on their identified category.
  • Structure Validation: Supports validating repository structure by ensuring files are in their correct categorical locations.
  • Use Case: You've just integrated a batch of new Markdown files into a repository. Use this skill to automatically categorize each file, identify if it's a new skill, command, agent, or documentation, and suggest its optimal location, saving hours of manual sorting.

Quick Start

Use the file-categorization skill to categorize the attached new-feature-command.md file.

Frequently Asked Questions about file-categorization

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

FAQPage Schema
How do I automatically categorize files in my repository by type?

File categorization analyzes filename patterns, YAML frontmatter, content structure, and keywords to automatically assign each file a type—Command, Agent, Skill, Documentation, or Other—with a confidence level, eliminating manual sorting and ensuring consistent organization across your repository.

Can I use file categorization to validate my repository structure?

Yes. File categorization validates that files are located in their correct categorical directories by comparing detected file types against actual locations, surfacing misplaced or miscategorized items and enforcing structural consistency.

What happens after files are categorized—can they be automatically routed?

After categorization, the skill provides type assignments and confidence scores that support automated routing pipelines, allowing files to be moved to appropriate directories, integrated into processing workflows, or flagged for review based on their detected category.

Does file categorization work with Markdown files and YAML frontmatter?

Yes. File categorization specifically analyzes Markdown files using YAML frontmatter detection alongside filename patterns and content structure analysis, making it well-suited for documentation, commands, agents, and skills written in Markdown format.

What's the difference between using filename patterns versus content analysis for categorization?

Filename patterns provide fast, rule-based classification; content analysis—including YAML frontmatter and keyword detection—offers deeper accuracy for ambiguous cases. File categorization combines both methods in a multi-phase approach to maximize precision and reduce false classifications.

Can file categorization handle diverse project types?

Yes. File categorization applies filename pattern matching, YAML frontmatter analysis, content-structure detection, and keyword detection across diverse projects, supporting varied repository structures and file organizations while maintaining consistent categorization logic.