sccmhunter-install-local

main@e655f93
Download ZIP
SpecterOps/skills/plugins/ops-sccm/skills/sccmhunter-install-local
npx skills add SpecterOps/skills --skill sccmhunter-install-local
SKILL.md
namesccmhunter-install-local
descriptionClone SCCMHunter into operating-tools and install it in a local Python virtual environment using the repository's documented setup flow.
metadata{"author":"GhostWorks"}

SCCMHunter Local Install

Use this skill to install SCCMHunter in a local, repo-adjacent workspace without polluting the main project environment.

This skill follows the validated workflow:

  • clone the SCCMHunter repo into operating-tools/SCCMHunter
  • create/use operating-tools/.venv
  • install from requirements.txt
  • verify with python3 sccmhunter.py -h
  • keep operating-tools/ ignored in git

Direct Triggers

Use this skill when the task mentions any of the following:

  • install SCCMHunter
  • clone SCCMHunter
  • local SCCM tooling setup
  • operating-tools environment
  • repo-local SCCMHunter virtualenv

Input Contract

Accept input as: BASE_DIR [MODE]

Where:

  • BASE_DIR defaults to current repo root
  • MODE is execute (default) or plan

Examples:

  • $sccmhunter-install-local execute
  • $sccmhunter-install-local /home/defaultuser/Working/codex-config execute
  • $sccmhunter-install-local /path/to/repo plan

Preconditions

  1. Confirm target directory is operator-controlled.
  2. Confirm git and python3 are available.
  3. Confirm outbound access to GitHub is permitted in the environment.
  4. Ensure operating-tools/ is git-ignored before completion.

Execution Workflow

  1. Prepare destination paths:
  • <BASE_DIR>/operating-tools
  • <BASE_DIR>/operating-tools/SCCMHunter
  • <BASE_DIR>/operating-tools/.venv
  1. Clone SCCMHunter if missing:
mkdir -p <BASE_DIR>/operating-tools
cd <BASE_DIR>/operating-tools
git clone https://github.com/garrettfoster13/sccmhunter.git SCCMHunter

If already present, do not reclone; reuse the existing checkout.

  1. Create/reuse virtualenv:
cd <BASE_DIR>/operating-tools
[ -d .venv ] || python3 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
  1. Install tool dependencies using repo instructions:
./.venv/bin/pip install -r <BASE_DIR>/operating-tools/SCCMHunter/requirements.txt
  1. Verify SCCMHunter runs:
cd <BASE_DIR>/operating-tools/SCCMHunter
<BASE_DIR>/operating-tools/.venv/bin/python3 sccmhunter.py -h
  1. Ensure git exclusion exists in <BASE_DIR>/.gitignore:
  • required entry: operating-tools/

Output Requirements

For each run, include:

  • BASE_DIR used
  • whether clone was new or reused
  • virtualenv path
  • exact install command(s)
  • verification output snippet from sccmhunter.py -h
  • .gitignore status for operating-tools/
  • UTC timestamp

Troubleshooting

If install fails:

  1. verify network reachability to github.com and Python package indexes
  2. rerun pip install with verbose output:
./.venv/bin/pip install -v -r requirements.txt
  1. confirm Python version compatibility and report exact exception text