skills.rest
bitovi
bitoviOFFICIAL
Explore all skills by this author →
WebsiteGitHub

2-categorize-files

Categorize codebase files by role and output a JSON mapping.

Updated Nov 5, 2025
Search Tags:#automation#codebase#scanning#categorize#repository-analysis#json-output#file-roles
One-click install
npx skills add https://github.com/bitovi/context-generation-mvp --skill 2-categorize-files
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 2-categorize-files
Source: https://github.com/bitovi/context-generation-mvp/tree/main/.claude/skills/2-categorize-files
Command: npx skills add https://github.com/bitovi/context-generation-mvp --skill 2-categorize-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly gain visibility into a large codebase by automatically categorizing every file according to its role, reducing manual triage and onboarding time.

Core Features & Use Cases

  • Automated file categorization: Scan a repository and assign files to categories like react-components, utility-functions, hooks, types, and more.
  • Use Case: On a new project, run this Skill to generate a JSON mapping of file paths to categories, enabling faster codebase reviews and onboarding.
  • Flexible output: Produce results in a standard JSON format at ./output-folder/2-file-categorization.json (or your configured path) for downstream tooling.

Quick Start

Run the task to categorize all files in your repository and output the results to a JSON file at the specified location.

Frequently Asked Questions about 2-categorize-files

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

FAQPage Schema
How do I automatically categorize files in a codebase for onboarding?▼

Categorizing files in a codebase by role involves traversing source directories while ignoring dependencies like node_modules, then assigning files to categories such as react-components and hooks. This produces a JSON mapping of file paths to roles for quick codebase understanding.

What is the best way to generate a JSON mapping of repository file roles?▼

The best way to generate a JSON mapping of repository file roles is using a deterministic script that analyzes file paths and outputs the results to ./output-folder/2-file-categorization.json. This provides a standardized format for downstream tooling and quick codebase reviews.

Does automated file categorization ignore dependency directories like node_modules?▼

Yes, automated file categorization ignores dependency directories like node_modules. The scanning process specifically traverses source directories to categorize project files by role, ensuring dependencies do not clutter the final JSON output mapping.

What file categories can I assign when scanning a software repository?▼

When scanning a software repository, you can assign files to categories like react-components, utility-functions, hooks, and types. This automated categorization reduces manual triage by mapping file paths directly to their functional roles in the JSON output.

Can I use the JSON file categorization output for downstream analysis tooling?▼

Yes, you can use the JSON file categorization output for downstream analysis tooling. The Skill produces results in a standard JSON format at a configured path, enabling faster codebase reviews and integration with other repository-analysis processes.

Related Skills

Explore More Software Engineering Skills→
axiomanticaxiomantic
8

managing-artifacts

Organize generated artifacts into a centralized directory under ~/.local/spellbook.

Official
Advanced
apexradiusapexradius

onboard-dev

Automate developer onboarding by scanning repository metadata and mapping codebase architecture.

Official
Advanced
cryborg1211cryborg1211

Explore Codebase

Map codebase modules, dependencies, and relationships into a knowledge graph.

Community
Intermediate
bradtaylorsfbradtaylorsf
8

linear-ticket-analysis

Analyze Linear tickets to detect duplicates and investigate Git history for fixes.

Community
Intermediate