skills/inspecting-the-environment/SKILL.md
Fast environment briefing for agents and subagents. Use at session start to learn OS/shell, container/WSL/VM status, git repo + upstream + dirty state, Python venv status/locations, markdown folders to read, and availability of common tools (uv, mcpc, rg/grep/jq/git/python/node/npm/pnpm, etc.).
npx skillsauth add aufrank/agent-skills inspecting-the-environmentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Collect a quick, machine-readable snapshot of the current workspace so agents know operating constraints, dev tooling, and where to look first for context.
Generate JSON (default):
python scripts/inspect_environment.py
Readable text:
python scripts/inspect_environment.py --format text
Key fields:
os: system, release, version, machineshell: detected shell/command hostenvironment: container hint, WSL flag, VM hint (via systemd-detect-virt when available)git: repo presence, root, branch, upstream, dirty statepython: interpreter path/version, active venv/conda, whether running inside a venvvirtualenv_dirs: nearby .venv/venv/env foldersmarkdown_dirs: directories (depth-limited) containing .md files worth skimmingtools: availability of common CLIs (uv, mcpc, rg/grep/jq/git/python/node/npm/pnpm, etc.)--root PATH to inspect a different directory (default: cwd).--format json|text for programmatic vs quick-read output (default: json).--md-limit N / --md-depth N to cap markdown directory discovery (defaults: 40 dirs, depth 5; skips .git/node_modules/.venv/venv/.tox/dist/build/.cache).--extra-tool NAME (repeatable) to probe additional binaries./proc/1/cgroup; WSL is reported separately.systemd-detect-virt; missing tools yield null.tools
Build and execute modular DAG workflows for long-context processing using slice/map/reduce/recurse/compact/filter operators. Use for one-shot batch jobs, standalone map-reduce pipelines, or when the context-dag plugin is not installed. Trigger when input exceeds the model's context window, when reproducible logged pipelines are needed, or when multi-level recursive processing is required. If context-dag is installed, the plugin's bundled dag_runner.py provides the same capability with persistent artifact storage.
documentation
Write in Austin Frank's voice and style. Use this skill whenever generating text that should sound like Austin — strategy docs, charters, proposals, business cases, vision documents, staffing requests, stakeholder updates, cover letters, mission statements, org design documents, or any professional prose where the user wants Austin's distinctive voice. Also use when the user asks to review, edit, or improve a draft for voice consistency, or when they reference "my style", "my voice", "write like me", or "Austin's style".
tools
Use mcpc to interact with the Notion MCP server: connect sessions, search workspace content, fetch pages/databases, and run helper scripts for common Notion actions.
tools
Decide between a scripted workflow and an autonomous agent harness, then scaffold the chosen path. Use when scoping new agentic systems or tool integrations.