investigate-directory

Audit a directory's content and structure to infer its purpose and quality signals.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/gioe/python-libs --skill investigate-directory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate-directory
Source: https://github.com/gioe/python-libs/tree/main/.claude/skills/investigate-directory
Command: npx skills add https://github.com/gioe/python-libs --skill investigate-directory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auditing a directory to reveal its true purpose, structure, and project context, so teams understand what a folder actually does beyond its label.

Core Features & Use Cases

  • Infer directory purpose from content, structure, and project conventions.
  • Assess code quality signals such as naming consistency, presence of key files, and alignment with CLAUDE-like guidelines.
  • Produce a practical assessment describing drift, scope, and recommended actions for consolidation or reorganization.

Quick Start

Provide the target directory path and let the skill generate a plain-language audit without modifying any files.

Frequently Asked Questions about investigate-directory

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

FAQPage Schema
How do I audit a directory's purpose and quality in a codebase?

To audit a directory, analyze its content, structure, and project context to infer the true purpose and assess quality signals like naming consistency. This generates a plain-language assessment without modifying any files.

What is directory structure analysis used for?

Directory structure analysis reveals what a folder actually does beyond its label. It identifies scope, detects convention drift, and recommends actions for code consolidation or reorganization based on actual project content.

Can I assess code quality signals across multiple project directories?

Yes, you can apply the audit to target directories within the repository and across projects. It evaluates code quality signals including naming consistency, key file presence, and alignment with project guidelines.

How do I check if a folder aligns with project conventions?

You check folder alignment by inferring purpose from project context and comparing it against established conventions. The audit reports naming consistency, key file presence, and any detected drift from expected standards.

Does the directory audit modify my files or create tasks?

No, the directory audit is strictly read-only and does not modify files or create tasks. It only analyzes the target directory path and generates a practical assessment of its purpose and quality.

What is the best way to identify scope drift in a repository folder?

The best way to identify scope drift is to audit the directory's content and structure against project context. This produces a practical assessment describing drift and recommending actions for reorganization.