inspecting-the-environment

Generate a JSON report of the current workspace environment.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/aufrank/agent-skills --skill inspecting-the-environment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inspecting-the-environment
Source: https://github.com/aufrank/agent-skills/tree/main/skills/inspecting-the-environment
Command: npx skills add https://github.com/aufrank/agent-skills --skill inspecting-the-environment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a rapid, machine-readable overview of the current operating environment, enabling agents to understand constraints and available tools immediately.

Core Features & Use Cases

  • Environment Snapshot: Gathers OS details, shell information, container/WSL/VM status, Git repository state, and Python virtual environment configuration.
  • Tool Availability: Detects common command-line tools like uv, mcpc, rg, jq, git, python, node, and npm.
  • Use Case: At the start of a new coding session, an agent can run this Skill to quickly ascertain if it's operating within a Docker container, the current Git branch, and if node and npm are available for frontend development tasks.

Quick Start

Generate a JSON report of the current environment by running the inspect_environment.py script.

Frequently Asked Questions about inspecting-the-environment

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

FAQPage Schema
How do I check the current Python virtual environment and OS details for an agent session?

You can generate an environment snapshot for an agent session by running the inspect_environment.py script, which outputs a concise JSON report detailing the OS, shell, Python venv, and Git repository state.

What is the best way to detect if a script is running inside a Docker container or WSL?

To detect container or WSL status, use an environment inspection script that queries system metrics and outputs a machine-readable JSON report confirming whether the current workspace operates within a container or VM.

Can I check for common command-line tools like uv, rg, and jq before executing agent tasks?

Yes, you can check for common command-line tools by running an environment inspection script that detects the availability of tools like uv, rg, jq, git, python, node, and npm in the current workspace.

How do I get a machine-readable snapshot of Git repository state and shell information?

To get a machine-readable snapshot of Git repo state and shell information, run the inspect_environment.py script, which gathers these details into a concise JSON format for immediate agent processing.

Does the environment inspection script require any specific dependencies to run?

No, the environment inspection script requires no external dependencies to run, allowing an agent to quickly ascertain operating constraints and available development tooling without prior setup.