Agent skill

Shorebird Patch

by K9i-0 in K9i-0/ccpocket

Shorebird OTA パッチの作成・staging 配布(stable 昇格はユーザー実施). An agent skill from K9i-0/ccpocket.

MITAuto-check passedMobile

Install Shorebird Patch

skills CLI
$ npx skills add K9i-0/ccpocket --skill shorebird-patch -a claude-code

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

GitHub CLI
$ gh skill install K9i-0/ccpocket shorebird-patch --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/K9i-0/ccpocket.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/shorebird-patch .claude/skills/shorebird-patch && 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
shorebird-patch
GitHub stars
1.1k
Token cost
~687 tokens
SKILL.md length
138 words
Files
3
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Shorebird OTA パッチの作成・staging 配布(stable 昇格はユーザー実施). An agent skill from K9i-0/ccpocket.

  • Works in 6 steps: バージョン確認 → パッチ作成 (staging) → アセット差分の検証(重要) → …
  • Mobile work in your project
  • SKILL.md covers フロー概要, パッチ手順, npm scripts and トラブルシュート
  • Runs Shell scripts from its folder; calls bash and npm

What it does

Shorebird Patch is an agent skill from K9i-0/ccpocket. Shorebird OTA パッチの作成・staging 配布(stable 昇格はユーザー実施)

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `patch.sh` and `promote.sh`).

It sits in Mobile. The repository describes itself as: Mobile client for Codex and Claude — control coding agents from your phone via WebSocket bridge. The licence is MIT.

When your agent uses it

  • Mobile work in your project

Example prompts

  • “/shorebird-patch”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Bash(bash:*), Bash(shorebird:*), Bash(dart:*), Bash(xcrun:*), Bash(grep:*), Read

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. バージョン確認
  2. パッチ作成 (staging)
  3. アセット差分の検証(重要)
  4. 検証(staging)
  5. Promote (staging → stable)
  6. 完了報告

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(bash:*)
    • Bash(shorebird:*)
    • Bash(dart:*)
    • Bash(xcrun:*)
    • Bash(grep:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Shorebird Patch loads about 687 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 138 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from K9i-0/ccpocket at commit 8354ffd, republished under its MIT licence (© K9i-0). 138 words, ~687 tokens.

Download SKILL.mdSave it as .claude/skills/shorebird-patch/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
shorebird-patch
description
Shorebird OTA パッチの作成・staging 配布(stable 昇格はユーザー実施)
allowed-tools
Bash(bash:*), Bash(shorebird:*), Bash(dart:*), Bash(xcrun:*), Bash(grep:*), Read

Shorebird パッチ配布

Shorebird OTA パッチを staging に作成する。stable への昇格はユーザーが検証後に手動で実施する。

新バージョンのリリースは /release-mobile スキルを使用する。 アセット差分でパッチが適用されない場合も、/release-mobile でリリース後に再パッチする。

フロー概要

patch (staging) → デバッグ画面で検証 → ユーザーが promote (stable) → 全ユーザーに配信

パッチ手順

1. バージョン確認
bash
grep '^version:' apps/mobile/pubspec.yaml

version: X.Y.Z+N の値を記録する(= <version>)。

2. パッチ作成 (staging)

指定済みのプラットフォームを優先し、未指定なら iOS と Android の両方を staging に作成する。対象とバージョンを報告して進め、追加の承認は求めない。対象リリースが存在しない場合は、そのプラットフォームの未完了理由を報告する。

bash
# iOS
bash .claude/skills/shorebird-patch/patch.sh ios <version>

# Android
bash .claude/skills/shorebird-patch/patch.sh android <version>

# 両方の場合は順番に実行

スクリプトが以下を一括で行う:

  • shorebird patch で staging にパッチ作成
  • --allow-asset-diffs によりアセット変更の確認プロンプトを自動スキップ

完了後の出力から パッチ番号 を記録する(= <patch-number>)。

3. アセット差分の検証(重要)

パッチ出力に以下の警告が含まれていないか確認する:

[WARN] Your app contains asset changes, which will not be included in the patch.

この警告が出た場合、パッチは publish されるが実機に適用されない可能性が高い。

対処法

アセット差分が検出された場合、ユーザーに以下を報告する:

  1. 警告内容: どのファイルにアセット差分があるか(例: MaterialIcons-Regular.otf)
  2. 影響: パッチは作成されるが、デバイスでダウンロード後に適用されない
  3. 推奨対応: /release-mobile で新リリースを作成してから、クリーンな状態でパッチを再作成する
4. 検証(staging)

パッチが staging に配信されたら、以下の方法で検証する:

  • ローカル: shorebird preview --track=staging --release-version=<version>
  • 実機(TestFlight等): アプリのデバッグ画面(ロゴ5連打)→ Update Track を Staging に変更 → アプリ再起動
5. Promote (staging → stable)

このスキルでは stable への昇格は実行しない。検証が問題なければ、ユーザーが以下を手動実行する:

bash
bash .claude/skills/shorebird-patch/promote.sh <version> <patch-number>

エージェントは promote を自動実行せず、上記コマンドをそのまま案内する。

6. 完了報告

以下を報告する:

  • パッチ番号
  • 対象プラットフォーム
  • リリースバージョン
  • トラック: staging に配信済み
  • stable 昇格は未実施で、ユーザー実行待ちであること
  • アセット差分: あり/なし(ありの場合は警告を明記)
  • ユーザーがそのまま実行できる promote コマンド

npm scripts

bash
npm run shorebird:patch:android -- <release-version>
npm run shorebird:patch:ios -- <release-version>
npm run shorebird:promote -- <release-version> <patch-number>

トラブルシュート

  • アセット差分でパッチが適用されない: --allow-asset-diffs でパッチ作成は成功するが、アセット変更(フォント、画像等)を含むパッチは実機で適用に失敗する。/release-mobile で新リリースが必要
  • 署名エラー(exportArchive): IPA生成時のエラーはShorebirdパッチ自体には影響しない。パッチが Published Patch N! と表示されていれば成功
  • インタラクティブプロンプト: shorebird コマンドを直接実行する場合は --release-version フラグ必須(省略するとインタラクティブプロンプトで非TTY環境がエラーになる)
  • パッチが反映されない場合の確認: 設定画面のバージョン表示で (patch N) が出ているか確認。出ていなければShorebirdリリースビルドでない可能性がある
  • staging パッチの確認方法: デバッグ画面(ロゴ5連打)→ Update Track を Staging に変更 → アプリ再起動

© K9i-0, MIT. 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 in .claude/skills/shorebird-patch of K9i-0/ccpocket.

  • SKILL.md
  • patch.sh
  • promote.sh

Open the folder on GitHubat commit 8354ffd

Compare with similar skills

Shorebird Patch 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.

Shorebird Patch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shorebird Patch this skillK9i-0/ccpocket1.1k—~687Automated safety check: PassMIT
React Native Best Practicesvercel-labs/openreview1.7k17 repos~1.1kAutomated safety check: PassMIT
Swiftui Protwostraws/SwiftUI-Agent-Skill5.1k2 repos~1.5kAutomated safety check: PassMIT
Kortix Brandkortix-ai/suna20k—~4kAutomated safety check: PassCustom licence
Ip As LogoKartikLabhshetwar/better-shot2.4k1 repos~4.3kAutomated safety check: PassMIT
Compose Multiplatform Patternsmonta-app/ocpp-emulator1805 repos~2kAutomated safety check: PassApache-2.0

Similar skills

  • React Native Best Practices

    vercel-labs/openreview

    Official

    A prioritized rule set for React Native and Expo apps covering list performance, animation, navigation, UI patterns, state, rendering, monorepos and configuration.

    1.7k GitHub starsUsed in 17 repos~1.1k tokens
    MobileAuto-check passed
  • Swiftui Pro

    twostraws/SwiftUI-Agent-Skill

    Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance.

    5.1k GitHub starsUsed in 2 repos~1.5k tokens
    MobileAuto-check passed
  • Kortix Brand

    kortix-ai/suna

    Load FIRST for anything that carries the Kortix look or voice: product or mobile UI, copy of any kind, decks, social, images, email, CLI output, anything with the logo, and reviews of these.

    20k GitHub stars~4k tokensUpdated today
    MobileAuto-check passed
  • Ip As Logo

    KartikLabhshetwar/better-shot

    Generate extremely simple, cute, personified square character images with rounded heavy forms, two purposeful character colors, one solid background color, and a dominant lower-corner composition.

    2.4k GitHub starsUsed in 1 repo~4.3k tokens
    MobileAuto-check passed
  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    180 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Aso Appstore Screenshots

    adamlyttleapps/claude-skill-aso-appstore-screenshots

    Generate high-converting App Store screenshots by analyzing your app's codebase, discovering core benefits, and creating ASO-optimized screenshot images using Nano Banana Pro.

    1.8k GitHub starsUsed in 1 repo~9.6k tokens
    MobileAuto-check passed

More from K9i-0/ccpocket

All 17 skills in this repo
  • Sim Preview

    K9i-0/ccpocket

    iOSシミュレーターで動くFlutterアプリをExpo Device HubとTailscale HTTPSでスマホのブラウザへ配信・操作するときに使う。

    1.1k GitHub stars~711 tokensUpdated 5 days ago
    Auto-check passed
  • Codex Guide

    K9i-0/ccpocket

    Codex の使い方、CLI/app/IDE、rules・hooks・AGENTS.md・skills・subagents・config などを案内する。Codex や OpenAI 製品の仕様を答える前に必ず公式ドキュメントを確認し、rules/approval は codex execpolicy check で実検証すること。

    1.1k GitHub stars~475 tokensUpdated 5 days ago
    Auto-check passed
  • Submit Store Review

    K9i-0/ccpocket

    既存の安定ビルドをApp Store / Google Playの審査へ提出・再提出する。新規ビルドはrelease-appを使う。

    1.1k GitHub stars~1.8k tokensUpdated 5 days ago
    Auto-check passed
  • Web Preview

    K9i-0/ccpocket

    Flutter Web版をビルドしてユーザーにプレビューURLを案内する。playwright-cliでアクセス確認も行う。

    1.1k GitHub stars~359 tokensUpdated 5 days ago
    Auto-check passed
  • Flutter UI Design

    K9i-0/ccpocket

    Flutter UI実装のアーキテクチャ規約・コンポーネント分割・状態管理ガイド(Bloc/Cubit版). An agent skill from K9i-0/ccpocket.

    1.1k GitHub stars~1.2k tokensUpdated 5 days ago
    Auto-check passed
  • Flutter Upgrade

    K9i-0/ccpocket

    Flutter SDKのアップグレード、または指定バージョンへの移行影響を調査するときに使う. An agent skill from K9i-0/ccpocket.

    1.1k GitHub stars~789 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Shorebird Patch

What does Shorebird Patch do?

Shorebird OTA パッチの作成・staging 配布(stable 昇格はユーザー実施). An agent skill from K9i-0/ccpocket. Shorebird Patch is an agent skill from K9i-0/ccpocket.

When should I use Shorebird Patch?

Shorebird Patch fits situations like: mobile work in your project.

How do I install Shorebird Patch in Claude Code?

Run `npx skills add K9i-0/ccpocket --skill shorebird-patch -a claude-code`. Or copy the skill folder (.claude/skills/shorebird-patch in K9i-0/ccpocket) into .claude/skills/shorebird-patch in your project. Claude Code loads it when a task matches its description.

How do I install Shorebird Patch in Codex?

Run `npx skills add K9i-0/ccpocket --skill shorebird-patch -a codex`. Or copy the skill folder (.claude/skills/shorebird-patch in K9i-0/ccpocket) into .agents/skills/shorebird-patch in your project. Codex loads it when a task matches its description.

Can I use Shorebird Patch 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 K9i-0/ccpocket --skill shorebird-patch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shorebird-patch, .gemini/skills/shorebird-patch, .github/skills/shorebird-patch and .opencode/skills/shorebird-patch in your project.

What does Shorebird Patch need to run?

Going by SKILL.md and its folder, Shorebird Patch needs a shell for the scripts in its folder and the command-line tools its instructions call (bash and npm). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Bash(bash:*), Bash(shorebird:*), Bash(dart:*), Bash(xcrun:*), Bash(grep:*), Read.

Does Shorebird Patch access the network?

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

Is Shorebird Patch 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. Review the folder before installing.

What licence does Shorebird Patch use?

Shorebird Patch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shorebird Patch use?

About 687 tokens (SKILL.md is roughly 2.7k 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 Shorebird Patch?

Skills that share tags, products or a category with Shorebird Patch: React Native Best Practices (vercel-labs/openreview, 1.7k stars), Swiftui Pro (twostraws/SwiftUI-Agent-Skill, 5.1k stars), Kortix Brand (kortix-ai/suna, 20k stars) and Ip As Logo (KartikLabhshetwar/better-shot, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shorebird Patch?

K9i-0 (a GitHub user) maintains it in K9i-0/ccpocket, which has 1,083 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 3, 2026.

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