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

生产力与工作流

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.

主要功能

Standardized project-info reporting for consistent AI context
Discovery of project-specific directories for source, tests, and docs
Detection of configuration files for Sphinx, mise, and other tools
Precise identification of virtual environment executable paths
0 GitHub stars
Automatic package name and version extraction from pyproject.toml

使用场景

Identifying project metadata and versioning during automated release workflows
Locating the correct python and pytest paths within a complex virtual environment
Mapping out directory structures when onboarding Claude to a new Python codebase

关于

主要功能

Standardized project-info reporting for consistent AI context
Discovery of project-specific directories for source, tests, and docs
Detection of configuration files for Sphinx, mise, and other tools
Precise identification of virtual environment executable paths
0 GitHub stars
Automatic package name and version extraction from pyproject.toml

使用场景

Identifying project metadata and versioning during automated release workflows
Locating the correct python and pytest paths within a complex virtual environment
Mapping out directory structures when onboarding Claude to a new Python codebase