Do I need to install shai-py manually?

The skill leverages uvx to run shai-py dynamically, meaning it can fetch and execute the necessary logic without a permanent global installation.

Can it read package information from pyproject.toml?

Yes, it specifically targets pyproject.toml to extract the package name, version, and other relevant project metadata.

Does it help with running tests?

Yes, by identifying the exact path to the pytest executable within the project's virtual environment, it ensures tests are run correctly.

How does this skill identify virtual environment paths?

The skill uses the shai-py utility to scan the local project directory for common virtual environment patterns and configuration files like mise.toml.

What documentation tools are supported?

It currently detects documentation roots and configuration files for tools like Sphinx (conf.py).

Python Project Inspector

Name: Python Project Inspector
Author: MacHu-GWU

byMacHu-GWU

0•

Productivity & Workflow

Automatically detects and displays Python project metadata, virtual environment paths, and core directory structures.

The Python Project Metadata skill streamlines development workflows by providing Claude with immediate visibility into a Python project's internal structure and environment. By leveraging the shai-py utility, it automatically extracts package versions from pyproject.toml, identifies active virtual environment paths for python, pip, and pytest, and locates essential directories for source code, tests, and documentation. This eliminates manual path searching and ensures Claude uses the correct local environment settings for execution and testing.

Key Features

01Standardized project-info reporting for consistent AI context

02Discovery of project-specific directories for source, tests, and docs

03Detection of configuration files for Sphinx, mise, and other tools

04Precise identification of virtual environment executable paths

050 GitHub stars

06Automatic package name and version extraction from pyproject.toml

Use Cases

01Identifying project metadata and versioning during automated release workflows

02Locating the correct python and pytest paths within a complex virtual environment

03Mapping out directory structures when onboarding Claude to a new Python codebase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add machu-gwu/sanhe-claude-code-plugins python-project-metadata

For use in Claude.ai and ChatGPT

Download Skill