Initial commit

skills/github-repo-setup/reference/error-handling.md

@@ -0,0 +1,63 @@
+# Error Handling
+
+## Common Issues
+
+### GitHub CLI not authenticated
+
+**Detect**: `gh auth status` fails
+
+**Solution**:
+```bash
+gh auth login
+# Follow prompts to authenticate
+```
+
+### Repository name conflicts
+
+**Detect**: API error for existing repo
+
+**Solution**:
+- Check availability: `gh repo view <owner>/<name>`
+- Suggest alternative names
+- Offer to use different organization
+
+### Insufficient permissions
+
+**Detect**: 403 errors from API
+
+**Solution**:
+- Verify organization membership
+- Check repository permissions
+- Contact organization admin for elevated access
+
+### Missing git configuration
+
+**Detect**: `git config` returns empty
+
+**Solution**:
+```bash
+git config --global user.name "Your Name"
+git config --global user.email "your@email.com"
+```
+
+### Rate limiting
+
+**Detect**: 429 errors from API
+
+**Solution**:
+- Wait for rate limit reset
+- Check limit: `gh api /rate_limit`
+- Retry with exponential backoff
+
+## Success Criteria
+
+- [ ] Repository created with appropriate visibility
+- [ ] Security features enabled (Dependabot, secret scanning)
+- [ ] Complete documentation (README, LICENSE, community files)
+- [ ] CI/CD workflows configured and functional
+- [ ] Issue and PR templates set up
+- [ ] Branch protection rules active (enterprise/team modes)
+- [ ] CODEOWNERS configured (team mode)
+- [ ] Repository accessible and cloneable
+- [ ] Validation checks pass
+- [ ] User has clear next steps