Skip to content

How The Skill Works

m4bwav edited this page Nov 21, 2026 · 1 revision

The plugin has one skill, shieldwright, plus sw.py and five reference notes the skill opens when a route needs them.

Hard rules

  1. Defensive only. It checks your own repositories, accounts and machines. Attack tooling, scanning systems you do not own, password cracking, phishing kits or getting into someone else's account are refused, with the defensive version offered instead.
  2. Never asks for, prints or stores a secret. Findings are reported by type and location, masked. A password to check goes through sw.py pwned, never the chat or a command-line argument.
  3. Rotate before scrub. A leaked secret is fixed at its issuer; rewriting history is cleanup.
  4. You run destructive steps. git filter-repo, force-push, revoking tokens, wiping a device and changing account settings are printed as commands or steps. The agent runs one only when you say so in that conversation.
  5. Unavailable is not off. A GitHub feature that needs a paid plan is reported as unavailable, never as switched off.

Routes

You ask It does Reference note
leaked key, secret in a commit, scan my repo sw.py repo PATH, then rotate and scrub repo-leak
audit my repos' security settings sw.py gh OWNER/REPO or sw.py gh OWNER repo-leak
accounts, passwords, 2FA, password manager a checklist; per-account answers on a decision page accounts
is my PC secure sw.py device device
was this password breached sw.py pwned, which you type into accounts
clicked a link, hacked account, lost phone, ransom note, sextortion email, token in a commit sw.py incident NAME, step by step incidents
kids' accounts, family devices a short checklist family

The reference notes are in skills/shieldwright/references.

Neighbours

Dependabot and pull request triage belong to everkeep, Windows shell quirks to quirkwright, and installing gitleaks or gh to evergreen-setup.

Clone this wiki locally