- name
- sccmhunter-install-local
- description
- Clone 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`
2. Clone SCCMHunter if missing:
```bash
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.
3. Create/reuse virtualenv:
```bash
cd <BASE_DIR>/operating-tools
[ -d .venv ] || python3 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
```
4. Install tool dependencies using repo instructions:
```bash
./.venv/bin/pip install -r <BASE_DIR>/operating-tools/SCCMHunter/requirements.txt
```
5. Verify SCCMHunter runs:
```bash
cd <BASE_DIR>/operating-tools/SCCMHunter
<BASE_DIR>/operating-tools/.venv/bin/python3 sccmhunter.py -h
```
6. 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:
```bash
./.venv/bin/pip install -v -r requirements.txt
```
3. confirm Python version compatibility and report exact exception text
GitHubで見る