Agent skill

Pre Push Guard

by qianyumeng0228 in qianyumeng0228/ShizukuX

ShizukuX codebase integrity checks. An agent skill from qianyumeng0228/ShizukuX.

Apache-2.0Auto-check passedMobile

Install Pre Push Guard

skills CLI
$ npx skills add qianyumeng0228/ShizukuX --skill pre-push-guard -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qianyumeng0228/ShizukuX pre-push-guard --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qianyumeng0228/ShizukuX.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pre-push-guard .claude/skills/pre-push-guard && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pre-push-guard
GitHub stars
119
Token cost
~584 tokens
SKILL.md length
247 words
Files
3 (incl. scripts)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

ShizukuX codebase integrity checks. An agent skill from qianyumeng0228/ShizukuX.

  • Works in 3 steps: Execute the validation script: Run the… → Review results: Analyze any FAIL or WARN… → Apply fixes: Correct any identified…
  • Tasks that involve Android development
  • SKILL.md covers Workflow, Automated Checks, Usage and Common Outliers to Watch For
  • Runs Shell scripts from its folder; calls bash and git

What it does

Pre Push Guard is an agent skill from qianyumeng0228/ShizukuX. ShizukuX codebase integrity checks. Use before pushing or committing to ensure no common build-breaking issues (CMake versions, missing imports, Java/Kotlin interop) exist.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `install-hooks.sh` and `scripts/pre_push_check.sh`).

It sits in Mobile, covering Android development. It works with Kotlin, C++, Java and Android. The repository describes itself as: ShizukuX 是 Shizuku 的增强分支:让普通应用借助 ADB / Root 特权进程直接调用系统级 API,并内置 Dhizuku、Extra API、Root 兼容桥等高级能力。继承自 ShizukuPlus(Apache 2.0)。 The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Android development

Example prompts

  • “/pre-push-guard”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Execute the validation script: Run the bundled bash script to perform all automated checks.
  2. Review results: Analyze any FAIL or WARN outputs.
  3. Apply fixes: Correct any identified issues before pushing.

What it can do on your machine

Read from SKILL.md and the folder at commit 6f7bc0b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pre Push Guard loads about 584 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 247 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~584

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from qianyumeng0228/ShizukuX at commit 6f7bc0b, republished under its Apache-2.0 licence (© qianyumeng0228). 247 words, ~584 tokens.

Download SKILL.mdSave it as .claude/skills/pre-push-guard/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
pre-push-guard
description
ShizukuX codebase integrity checks. Use before pushing or committing to ensure no common build-breaking issues (CMake versions, missing imports, Java/Kotlin interop) exist.

Pre-Push Guard

This skill automates the verification of common issues that have caused GitHub Action build failures in the ShizukuX project.

Workflow

  1. Execute the validation script: Run the bundled bash script to perform all automated checks.
  2. Review results: Analyze any FAIL or WARN outputs.
  3. Apply fixes: Correct any identified issues before pushing.

Automated Checks

The scripts/pre_push_check.sh script performs the following:

  • CMake Version: Verifies cmake_minimum_required is set to 3.22.1 (runner standard).
  • Java/Kotlin Interop: Ensures Java files access Kotlin objects via .INSTANCE (e.g., BuildUtils.INSTANCE).
  • Resource Integrity: Scans strings.xml for duplicate attribute names.
  • Kotlin Imports: Detects missing import af.shizuku.manager.R when R is used.
  • Ambiguous Imports: Finds duplicate android.os.Bundle imports.
  • Coroutine Contexts: Verifies that launch and Dispatchers have their required kotlinx.coroutines imports, and that lifecycleScope has its androidx.lifecycle import.
  • Syntax Integrity: Detects Kotlin files where import statements are accidentally placed below the class definition.
  • Submodule Sync: Ensures the local api submodule commit actually exists on the remote before allowing a push.
  • AAPT Errors: Prevents Android resource linking failed by scanning for hardcoded package names (e.g., xyz.shizuku.extra.api:) in XML.
  • Theme References: Warns if colorPrimary is used directly in Kotlin without the R.attr. prefix.
  • Diagnostic Quality: Flags remaining `` calls.

Usage

bash
bash pre-push-guard/scripts/pre_push_check.sh

Common Outliers to Watch For

  • Submodule Desync: Always check git status for "modified content" in the api submodule.
  • Dependency Leakage: Ensure new library features used in server are also declared in server/build.gradle.
  • Layout Shadowing: In AppBarActivity subclasses, ensure local binding variables don't shadow parent fields if parent access is needed.

© qianyumeng0228, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in pre-push-guard of qianyumeng0228/ShizukuX.

  • SKILL.md
  • install-hooks.sh
  • scripts/pre_push_check.sh

Open the folder on GitHubat commit 6f7bc0b

Compare with similar skills

Pre Push Guard next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pre Push Guard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pre Push Guard this skillqianyumeng0228/ShizukuX119—~584Automated safety check: PassApache-2.0
Find Untested Sourcesmicrosoft/testfx1k2 repos~3.3kAutomated safety check: PassMIT
Android Maps Ktxgooglemaps/android-maps-ktx360—~897Automated safety check: PassApache-2.0
Jugg Android Dev Loopniki914/zafiro241—~2kAutomated safety check: PassMIT
Android Audio E2Ehyochan/react-native-nitro-sound961—~814Automated safety check: PassMIT
Project Binding Adapter From SourceafkT/DevUtils1.6k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Find Untested Sources

    microsoft/testfx

    Official

    MANDATORY for static source-to-test pairing: find or list source files/modules without corresponding tests, or suggest test locations from repository structure.

    1k GitHub starsUsed in 2 repos~3.3k tokens
    MobileAuto-check passed
  • Android Maps Ktx

    googlemaps/android-maps-ktx

    Provides idiomatic Kotlin extension (KTX) patterns, reactive Flow event streams, and multi-subscriber shareIn rules for Google Maps SDK for Android and its Utility Library.

    360 GitHub stars~897 tokensUpdated 3 days ago
    MobileAuto-check passed
  • Jugg Android Dev Loop

    niki914/zafiro

    A skill your agent uses when editing source files (Java/Kotlin/XML/layout/AndroidManifest/Gradle) in a Android project, or when user asks to build/deploy/verify an Android app.

    241 GitHub stars~2k tokensUpdated today
    MobileAuto-check passed
  • Android Audio E2E

    hyochan/react-native-nitro-sound

    Build and run device-backed Android end-to-end checks for react-native-nitro-sound permissions, recording, playback, listeners, pause/resume, seek, speed, audio focus, lifecycle behavior, and rapid…

    961 GitHub stars~814 tokensUpdated 11 days ago
    MobileAuto-check passed
  • 根据用户给出的 Java/Kotlin 工具类或 View 相关源码,设计并实现 androidx.databinding.BindingAdapter。

    1.6k GitHub stars~1.6k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Kotlin

    margelo/react-native-skills

    Design, implement, and review Kotlin and Android APIs. An agent skill from margelo/react-native-skills.

    175 GitHub stars~3k tokensUpdated 1 mo ago
    MobileAuto-check passed

More from qianyumeng0228/ShizukuX

  • Sentry Audit

    qianyumeng0228/ShizukuX

    Fetches unresolved Sentry issues and maps stack traces to local codebase for ShizukuPlus.

    119 GitHub stars~490 tokensUpdated 4 days ago
    Auto-check passed
  • Shizukuplus

    qianyumeng0228/ShizukuX

    Guidelines and instructions for developing, testing, and troubleshooting ShizukuPlus (an enhanced Shizuku manager with OneUI 8+ fixes, Dhizuku mode, and Plus APIs).

    119 GitHub stars~375 tokensUpdated 4 days ago
    Auto-check passed
  • Lint Repair

    qianyumeng0228/ShizukuX

    Automates running Android Lint and repairing errors/warnings in the codebase.

    119 GitHub stars~378 tokensUpdated 4 days ago
    Auto-check passed
  • MCP Setup

    qianyumeng0228/ShizukuX

    Spawns and configures Model Context Protocol (MCP) integrations for ShizukuPlus.

    119 GitHub stars~289 tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Pre Push Guard

What does Pre Push Guard do?

ShizukuX codebase integrity checks. An agent skill from qianyumeng0228/ShizukuX. Pre Push Guard is an agent skill from qianyumeng0228/ShizukuX. ShizukuX codebase integrity checks.

When should I use Pre Push Guard?

Pre Push Guard fits situations like: tasks that involve Android development.

How do I install Pre Push Guard in Claude Code?

Run `npx skills add qianyumeng0228/ShizukuX --skill pre-push-guard -a claude-code`. Or copy the skill folder (pre-push-guard in qianyumeng0228/ShizukuX) into .claude/skills/pre-push-guard in your project. Claude Code loads it when a task matches its description.

How do I install Pre Push Guard in Codex?

Run `npx skills add qianyumeng0228/ShizukuX --skill pre-push-guard -a codex`. Or copy the skill folder (pre-push-guard in qianyumeng0228/ShizukuX) into .agents/skills/pre-push-guard in your project. Codex loads it when a task matches its description.

Can I use Pre Push Guard in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qianyumeng0228/ShizukuX --skill pre-push-guard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pre-push-guard, .gemini/skills/pre-push-guard, .github/skills/pre-push-guard and .opencode/skills/pre-push-guard in your project.

What does Pre Push Guard need to run?

Going by SKILL.md and its folder, Pre Push Guard needs a shell for the scripts in its folder and the command-line tools its instructions call (bash and git). Our summary lists: A Bash shell.

Does Pre Push Guard access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pre Push Guard safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pre Push Guard use?

Pre Push Guard is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pre Push Guard use?

About 584 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pre Push Guard?

Skills that share tags, products or a category with Pre Push Guard: Find Untested Sources (microsoft/testfx, 1k stars), Android Maps Ktx (googlemaps/android-maps-ktx, 360 stars), Jugg Android Dev Loop (niki914/zafiro, 241 stars) and Android Audio E2E (hyochan/react-native-nitro-sound, 961 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pre Push Guard?

qianyumeng0228 (a GitHub user) maintains it in qianyumeng0228/ShizukuX, which has 119 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: qianyumeng0228/ShizukuX on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.