← Back to Skills Marketplace

GitHub Push CN

Name: GitHub Push CN
Author: onlyloveher

by onlyloveher · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

111

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install github-push-cn

Description

Secure GitHub push automation with auto SSH and remote config. Use when git push, automated push, or conflict handling needed.

README (SKILL.md)

GitHub Push - Secure Auto-Push Tool

Automated GitHub push with:

Auto SSH Config: Auto-detect and load SSH keys
Auto Remote Config: Auto-add git remote origin
Auto Conflict Resolution: Auto pull + rebase + force
Anti-Ban Mechanism: Rate limiting + commit batching + smart validation

Installation

No external dependencies required. Uses standard Git CLI (always available).

Usage Examples

# Quick push (auto-configures everything)
python3 scripts/github_upload.py --repo owner/repo --path ./files --message "Update"

# Dry run test (no actual push)
python3 scripts/github_upload.py --repo owner/repo --path ./files --dry-run

# Force push (auto-resolves conflicts)
python3 scripts/github_upload.py --repo owner/repo --path ./files --force

# Show version info
python3 scripts/github_upload.py --version

Configuration

Create config.yaml for persistent settings:

defaults:
  safe_mode: true
  min_delay: 3  # seconds between operations
  max_delay: 5  # seconds between operations
  batch_commits: true
  enable_validation: true
  dry_run: false
  
safety:
  max_commits_per_hour: 100
  max_pushes_per_hour: 50
  min_time_between_pushes: 180  # 3 minutes cooldown

Safety Thresholds

Metric	Default	Description
Delay between ops	3-5s	Randomized delay
Push cooldown	180s	Min time between pushes
Max pushes/hour	50	Anti-spam limit
Max commits/hour	100	Anti-automation limit

Troubleshooting

Error: "Too frequent pushes"

Solution: Wait at least 3 minutes before next push.

Error: "Repository not found"

Solution: Check repository exists and you have push access. Verify SSH key is added to GitHub.

Error: "Permission denied (publickey)"

Solution:

# Load SSH key
ssh-add ~/.ssh/id_ed25519

# Verify SSH connection
ssh -T [email protected]

Error: "Merge conflict"

Solution: The script handles this automatically with pull + rebase + force. Check repository state if issue persists.

Error: "Validation failed"

Solution:

Check path exists and is accessible
Verify files don't exceed 100MB (GitHub limit)
Check for suspicious patterns (e.g., .env, id_rsa)

When Not to Use

Just viewing GitHub content
Creating issues or PRs
Code review

References

references/ - Detailed config and API docs
scripts/ - Full code examples

MIT License - OpenClaw Skill Standard

Usage Guidance

This skill can perform destructive changes and touch private SSH keys. Before installing or running: 1) Review the script lines that remove .git and that call 'ssh-add'—back up any repositories (copy the .git directory) and never run it on a production repo. 2) Prefer running with --dry-run first and inspect the computed file list. 3) Check that you understand and consent to auto-loading private keys into your ssh-agent; consider using a dedicated key with limited access. 4) Be cautious about the 'auto-create repo' claim—the package supplies no GitHub API token handling, so verify how repository creation is actually implemented. 5) If you intend to let an autonomous agent use this skill, restrict agent permissions and test in an isolated environment. If anything is unclear, ask the author for explicit confirmation of destructive steps and for safeguards such as explicit user confirmation before removing .git or doing force-pushes.

Capability Analysis

Type: OpenClaw Skill Name: github-push-cn Version: 1.0.0 The skill bundle implements automated GitHub push functionality with high-risk behaviors in `scripts/github_upload.py`. Specifically, it automatically searches for and loads SSH private keys from the user's `~/.ssh` directory into the SSH agent and destructively deletes existing `.git` directories in the target path to force re-initialization. While these actions are documented as 'zero-setup' features, they pose significant risks of unauthorized credential usage and loss of local git history/metadata.

Capability Assessment

ℹ Purpose & Capability

The name/description (GitHub push automation) aligns with the code and docs: it manipulates git, configures/remotes, and performs pushes. However some claims are questionable or under-specified (e.g., 'auto-create repo if doesn't exist' requires GitHub API/credentials but the skill declares no such credential). Re-initializing by removing an existing .git (documented in code) is surprising relative to a typical 'push' helper.

⚠ Instruction Scope

Runtime behavior includes reading the user's home (~/.ssh), invoking ssh-add to load private keys, manipulating git config (user.name/email), removing .git (shutil.rmtree) and re-initializing repositories, staging/committing, pulling/rebasing and force-pushing. These are powerful, potentially destructive filesystem and credential operations that go beyond a passive 'push helper' and are not gated by strong user confirmation in the docs.

✓ Install Mechanism

No remote install or third-party downloads—this is contained in the shipped code. That lowers supply-chain risk compared to network installs. The skill executes local subprocesses (git, ssh-add) which are expected for this function.

⚠ Credentials

The skill requests no declared env vars but reads and acts on sensitive local material: it auto-detects and will auto-load private SSH keys from ~/.ssh into the ssh-agent. Access to SSH keys and removal of .git are high-impact operations and should be explicitly declared and justified. The lack of declared credentials or clear safeguards is disproportionate to what the metadata states.

⚠ Persistence & Privilege

The skill does not set 'always' and is user-invocable, but it performs persistent/modifying actions on the user's repository state (deleting .git, changing remotes, configuring user.email/name). Those modifications affect local data and history and are not limited to a sandbox—this is higher privilege than a read-only helper.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install github-push-cn
After installation, invoke the skill by name or use /github-push-cn
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Initial release with CN suffix

Metadata

Slug github-push-cn

Version 1.0.0

License MIT-0

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is GitHub Push CN?

Secure GitHub push automation with auto SSH and remote config. Use when git push, automated push, or conflict handling needed. It is an AI Agent Skill for Claude Code / OpenClaw, with 111 downloads so far.

How do I install GitHub Push CN?

Run "/install github-push-cn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GitHub Push CN free?

Yes, GitHub Push CN is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GitHub Push CN support?

GitHub Push CN is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub Push CN?

It is built and maintained by onlyloveher (@onlyloveher); the current version is v1.0.0.

More Skills