Install SSW ContentHawk on a target repo
ContentHawk is a GitHub Actions pipeline for auditing repository content. Installing it on a target repo requires setting several GitHub Actions secrets via the gh CLI.
Steps
- Determine the target repo. If the user hasn't already provided one, ask them for it in
owner/repoform before continuing. - Verify
ghis authenticated. Rungh auth status. If it fails, tell the user to rungh auth loginand stop. - Verify the user has their username set in their GitHub CLI config. Run
git config --global user.name. andgit config --global user.email. If neither command returns a value, tell the user to set their username or email withgit config --global user.name "Your Name"orgit config --global user.email "your.email@example.com"and stop. - Verify the correct agentic workflows CLI is installed run
gh aw --version. Ensure the version matches the one specified ingithub/gh-aw-actionshttps://raw.githubusercontent.com/SSWConsulting/SSW.ContentHawk/refs/heads/main/.github/aw/actions-lock.json. If the CLI fails tell the user to install the correct version from listed from theactions-lock.jsonand stop. - Run the installer. Run
npx ssw-contenthawk@latest install <owner/repo>.
The installer starts a local form server on 127.0.0.1, prints a http://127.0.0.1:<port>/?token=... URL on stderr, and opens it in the user's browser. When the process exits tell the thank the user for running the installer and tell them to re-run the skill if any issues occurred.