thatrebeccarae/claude-marketing / skills/safe-push
safe-push
VerifiedPre-push hygiene check for GitHub repositories. Scans for PII, secrets, and sensitive data before pushing. Audits commit messages, enforces repo-specific blocklists, and rate-limits pushes to avoid GitHub abuse detection. Use before any git push, especially to public repos.
| File | Kind | Size |
|---|---|---|
| EXAMPLES.md | markdown | 1.8 KB |
| LICENSE | other | 1.0 KB |
| REFERENCE.md | markdown | 4.2 KB |
| SKILL.md | skill md | 7.6 KB |
| safe-push-blocklist.template | other | 1.4 KB |
REFERENCE.md
View on GitHub# Safe Push — Reference
## Secret Detection Patterns
### API Keys and Tokens
| Pattern | Description |
|---------|-------------|
| `AKIA[0-9A-Z]{16}` | AWS Access Key ID |
| `[0-9a-zA-Z/+]{40}` (near AWS context) | AWS Secret Access Key |
| `ghp_[0-9a-zA-Z]{36}` | GitHub Personal Access Token |
| `gho_[0-9a-zA-Z]{36}` | GitHub OAuth Token |
| `ghs_[0-9a-zA-Z]{36}` | GitHub Server Token |
| `github_pat_[0-9a-zA-Z_]{82}` | GitHub Fine-grained PAT |
| `xoxb-[0-9]+-[0-9]+-[a-zA-Z0-9]+` | Slack Bot Token |
| `xoxp-[0-9]+-[0-9]+-[a-zA-Z0-9]+` | Slack User Token |
| `sk-[a-zA-Z0-9]{48}` | OpenAI API Key |
| `sk-ant-[a-zA-Z0-9-_]{90,}` | Anthropic API Key |
| `SG\.[a-zA-Z0-9_-]{22}\.[a-zA-Z0-9_-]{43}` | SendGrid API Key |
| `sk_live_[0-9a-zA-Z]{24,}` | Stripe Secret Key |
| `pk_live_[0-9a-zA-Z]{24,}` | Stripe Publishable Key |
| `sq0[a-z]{3}-[0-9A-Za-z_-]{22,}` | Square API Key |
### Private Keys
| Pattern | Description |
|---------|-------------|
| `-----BEGIN RSA PRIVATE KEY-----` | RSA Private Key |
| `-----BEGIN OPENSSH PRIVATE KEY-----` | SSH Private Key |
| `-----BEGIN PGP PRIVATE KEY BLOCK-----` | PGP Private Key |
| `-----BEGIN EC PRIVATE KEY-----` | EC Private Key |
| `-----BEGIN DSA PRIVATE KEY-----` | DSA Private Key |
### Generic Secrets
| Pattern | Description |
|---------|-------------|
| `password\s*[:=]\s*['"][^'"]+['"]` | Hardcoded password |
| `secret\s*[:=]\s*['"][^'"]+['"]` | Hardcoded secret |
| `api[_-]?key\s*[:=]\s*['"][^'"]+['"]` | Generic API key assignment |
| `token\s*[:=]\s*['"][^'"]+['"]` | Generic token assignment |
| `bearer\s+[a-zA-Z0-9_\-.~+/]+=*` | Bearer token in code |
### PII Patterns
| Pattern | Description |
|---------|-------------|
| `[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}` | Email address |
| `\b\d{3}[-.]?\d{3}[-.]?\d{4}\b` | US phone number |
| `\b\d{3}-\d{2}-\d{4}\b` | SSN |
| `\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b` (RFC 1918) | Private IP address |
### RFC 1918 Private IP Ranges
```
10.0.0.0/8 → 10.x.x.x
172.16.0.0/12 → 172.16.x.x through 172.31.x.x
192.168.0.0/16 → 192.168.x.x
```
Also flag Tailscale CGNAT range: `100.64.0.0/10` (100.64.x.x through 100.127.x.x).
## Staggered Push Implementation
```bash
# Multi-branch staggered push
branches=("main" "develop" "feature/new-feature")
for branch in "${branches[@]}"; do
echo "Pushing $branch..."
git push origin "$branch"
sleep 5
done
# Large commit batch push
total_commits=$(git rev-list --count origin/main..HEAD)
if [ "$total_commits" -gt 50 ]; then
echo "Large push detected ($total_commits commits). Staggering..."
# Push in batches using refspecs
commits=($(git rev-list --reverse origin/main..HEAD))
batch_size=50
for ((i=0; i<${#commits[@]}; i+=batch_size)); do
batch_end=$((i + batch_size - 1))
if [ $batch_end -ge ${#commits[@]} ]; then
git push origin HEAD:refs/heads/main
else
git push origin "${commits[$batch_end]}:refs/heads/main"
fi
echo "Pushed batch $((i/batch_size + 1)). Waiting 10s..."
sleep 10
done
fi
```
## Example .pii-allowlist
```
# Documentation examples
user@example\.com
test@example\.com
admin@example\.com
# RFC 5737 documentation IP ranges (safe to publish)
192\.0\.2\.\d+
198\.51\.100\.\d+
203\.0\.113\.\d+
# Example domains
example\.com
example\.org
example\.net
# Test fixtures
test-api-key-\w+
FAKE_TOKEN_\w+
```
## Example .commit-msg-blocklist
```
# Client names (add your own)
# client-name-here
# Internal infrastructure
# internal-hostname
# staging.internal
# Project codenames
# project-codename
```
## Commit Message Quality Guide
### Bad Messages (Flag These)
```
fix
update
wip
changes
stuff
misc
```
### Good Message Patterns
```
feat: add email validation to signup form
fix: prevent duplicate webhook deliveries
refactor: extract shared auth logic into middleware
docs: add API rate limit documentation
chore: upgrade dependencies to latest patch versions
```
## Pre-commit Hook Integration
Safe-push complements (does not replace) pre-commit hooks. Recommended pairing:
| Layer | Catches | When |
|-------|---------|------|
| Pre-commit hook | Secrets in staged files | Before each commit |
| Safe-push | Secrets across full diff, commit messages, push rate | Before each push |
Both layers should use the same `.pii-allowlist` for consistency.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |