JordanGunn/nunchuck / skills/sniff/sniff-locate
sniff-locate
VerifiedList findings in `.sniff/findings.jsonl`, validate anchors, reanchor stale findings when code shifts, and regenerate `.sniff/index.json`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 587 B |
| references/00_ROUTER.md | markdown | 533 B |
| references/01_SUMMARY.md | markdown | 727 B |
| references/02_TRIGGERS.md | markdown | 307 B |
| references/03_ALWAYS.md | markdown | 275 B |
| references/04_NEVER.md | markdown | 254 B |
| references/05_PROCEDURE.md | markdown | 722 B |
| references/06_FAILURES.md | markdown | 298 B |
| scripts/include/sniff_common.py | script | 5.2 KB |
| scripts/include/sniff_locate.py | script | 6.6 KB |
| scripts/include/sniff_locate_cli.py | script | 3.7 KB |
| scripts/skill.ps1 | script | 1.5 KB |
| scripts/skill.shexecutable | script | 1.3 KB |
scripts/include/sniff_locate_cli.py
View on GitHubfrom __future__ import annotations
import argparse
import subprocess
import sys
from pathlib import Path
def _repo_root() -> Path:
proc = subprocess.run(
["git", "rev-parse", "--show-toplevel"],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
check=False,
)
if proc.returncode == 0:
p = proc.stdout.decode("utf-8", errors="replace").strip()
if p:
return Path(p)
return Path.cwd()
def cmd_help() -> int:
print("sniff-locate commands:")
print(" help")
print(" validate")
print(" list [--all] [--smell NAME] [--group GROUP] [--path GLOB] [--json]")
print(" validate-findings [--all]")
print(" reanchor [--all]")
print(" clean")
return 0
def cmd_validate() -> int:
repo_root = _repo_root()
local = Path(__file__).resolve().parent
if not (local / "sniff_locate.py").exists():
print(f"error: missing implementation at {local}", file=sys.stderr)
return 1
if not (repo_root / ".git").exists():
print("error: not a git repository (missing .git)", file=sys.stderr)
return 1
print("ok: sniff-locate cli is runnable")
return 0
def cmd_list(args: argparse.Namespace) -> int:
repo_root = _repo_root()
from sniff_locate import format_human, format_json, list_findings
rows = list_findings(
repo_root,
smell=args.smell,
group=args.group,
path_glob=args.path,
include_all=args.all,
)
if args.json:
sys.stdout.write(format_json(rows))
else:
sys.stdout.write(format_human(rows))
return 0
def cmd_validate_findings(args: argparse.Namespace, *, reanchor: bool) -> int:
repo_root = _repo_root()
from sniff_locate import validate_findings
counts = validate_findings(repo_root, reanchor=reanchor, include_all=args.all)
print(
"ok: "
+ ", ".join(
[
f"active={counts.get('active', 0)}",
f"stale={counts.get('stale', 0)}",
f"missing={counts.get('missing', 0)}",
f"updated={counts.get('updated', 0)}",
]
)
)
return 0
def cmd_clean() -> int:
repo_root = _repo_root()
sniff_dir = repo_root / ".sniff"
for p in [sniff_dir / "index.json", sniff_dir / "state.json"]:
try:
if p.exists():
p.unlink()
except Exception:
pass
print("ok: cleaned derived .sniff artifacts (index/state)")
return 0
def main(argv: list[str]) -> int:
parser = argparse.ArgumentParser(add_help=False)
sub = parser.add_subparsers(dest="cmd")
sub.add_parser("help")
sub.add_parser("validate")
p_list = sub.add_parser("list")
p_list.add_argument("--all", action="store_true")
p_list.add_argument("--smell")
p_list.add_argument("--group")
p_list.add_argument("--path")
p_list.add_argument("--json", action="store_true")
p_v = sub.add_parser("validate-findings")
p_v.add_argument("--all", action="store_true")
p_r = sub.add_parser("reanchor")
p_r.add_argument("--all", action="store_true")
sub.add_parser("clean")
ns = parser.parse_args(argv[1:] if len(argv) > 1 else [])
cmd = ns.cmd or "help"
if cmd == "help":
return cmd_help()
if cmd == "validate":
return cmd_validate()
if cmd == "list":
return cmd_list(ns)
if cmd == "validate-findings":
return cmd_validate_findings(ns, reanchor=False)
if cmd == "reanchor":
return cmd_validate_findings(ns, reanchor=True)
if cmd == "clean":
return cmd_clean()
print(f"error: unknown command '{cmd}'", file=sys.stderr)
return 1
if __name__ == "__main__":
raise SystemExit(main(sys.argv))
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |