ramblurr/local-git-reference
prompts/skills/local-git-reference/SKILL.md
Use when looking up project docs, source, examples, specs, or upstream context, and extra/ does not contain what you need. Check ~/src first, clone relevant repos with ghq, and prefer local inspection/search over remote browsing.
testing
Updated Apr 21, 2026
$ install --global
skillsauthnpx skillsauth add ramblurr/nix-devenv local-git-referenceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 10:43 AM7.0s1 file scanned
SKILL.md
- name:
- local-git-reference
- description:
- Use when looking up project docs, source, examples, specs, or upstream context, and extra/ does not contain what you need. Check ~/src first, clone relevant repos with ghq, and prefer local inspection/search over remote browsing.
Local Git Reference
~/src is the human (and your) personal library of useful git repositories.
Use it for any git repo that may contain information relevant to the task, not just code repositories. That includes docs repos, examples, specs, infra repos, deployment repos, and companion repos related to a project.
Be proactive. If a project, tool, library, or service seems relevant, look for likely repos and clone them into ~/src so you can inspect and search them locally.
Related skills: extra-reference-material for material in extra/
Core workflow
- Look in
~/srcfor a relevant repo first. - If a likely useful repo is missing, clone it with
ghq clone. - Prefer reading and searching local files over browsing remote sites when practical.
- If currentness matters and the clone may be stale, run
git pullinside the repo before relying on it.
The docs repo may be different from the main code repo. If a docs site or project appears relevant, proactively look for related git repos and clone them too.
Standard commands
Clone a repo into ~/src:
ghq clone https://github.com/owner/repo.git
Clone a likely companion repo too when useful:
ghq clone https://github.com/owner/project-docs.git
Refresh a local clone when freshness matters:
cd ~/src/github.com/owner/repo && git pull --ff-only
Search helpers
Use the bundled scripts to search ~/src without dumping unbounded output into context.
scripts/find-repos.sh: find candidate repositories by path or repo namescripts/search-src.sh: search file contents under~/src
Both scripts:
- enforce a maximum number of displayed lines by default
- report how many matches were found in total
- report when output is truncated
- print full paths
Examples:
scripts/find-repos.sh caddy
scripts/search-src.sh 'reverse_proxy'
Increase the display cap deliberately when needed:
scripts/search-src.sh --max-results 80 'tls internal'
What to inspect inside a local repo
Prioritize the files most likely to answer the question:
README*docs/examples/- tests
- configuration files
- source files implementing the relevant feature
Use local repo contents as primary reference material whenever practical.
Decision rule
Err on cloning a relevant remote repo if it is not already present in ~/src. Local searchable checkouts are often faster and more useful than repeated remote browsing.
Related Skills
ramblurr/operational-change-protocol
testing
VerifiedTrustedCommunity
Use this OCP when executing or preparing to execute commands that change a live or important system, service reloads/restarts, package changes, deployments, migrations, firewall/network/access changes, credential rotation, NixOS switch/test/boot/deploy, or incident mitigation. It guides safe operations with a persisted ledger for scope, preflight, baseline, rollback, validation, and evidence.
SKILL.mdUpdated Jun 4, 2026
ramblurr/write-a-skill
development
VerifiedTrustedCommunity
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
SKILL.mdUpdated May 21, 2026
ramblurr/prompts-documents
documentation
VerifiedTrustedCommunity
Naming conventions for workflow documents in prompts/. Use when creating plans, PRDs, research reports, idea capture or other workflow documents. Triggers on (1) creating new planning documents, (2) naming PRDs or research reports, (3) questions about document organization in prompts/.
SKILL.mdUpdated May 21, 2026
ramblurr/grill-with-docs
testing
VerifiedTrustedCommunity
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
SKILL.mdUpdated May 21, 2026