Agent skill

Submit PR

by tisfeng in tisfeng/Easydict

创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

GPL-3.0Auto-check passedDevelopment

Install Submit PR

skills CLI
$ npx skills add tisfeng/Easydict --skill submit-pr -a claude-code

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

GitHub CLI
$ gh skill install tisfeng/Easydict submit-pr --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/tisfeng/Easydict.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/submit-pr .claude/skills/submit-pr && 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
submit-pr
GitHub stars
15k
Token cost
~595 tokens
SKILL.md length
223 words
Files
6 (incl. scripts, references, assets)
Skills in repo
8
Repo updated
First seen
Licence
GPL-3.0

At a glance

创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

  • Works in 7 steps: 读取 工作流契约,确定用户语言、固定正文、Issue 策略、repository → 记录 HEAD、当前分支和 staged、unstaged、untracked… → plan 模式只使用现有提交和缓存的远程事实,运行 helper plan… → …
  • Tasks that involve Commit messages
  • SKILL.md covers 模式与授权, 主流程 and 安全、完成与停止
  • Runs Python scripts from its folder; calls git

What it does

Submit PR is an agent skill from tisfeng/Easydict. 创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/pull_request_template.md` and `references/workflow.md`).

It sits in Development, covering Commit messages and Pull requests. It works with GitHub and Git. The repository describes itself as: 一个简洁优雅的词典翻译 macOS App。开箱即用,支持离线 OCR 识别,支持有道词典,🍎 苹果系统词典,🍎 苹果系统翻译,OpenAI,Gemini,DeepL,Google,Bing,腾讯,百度,阿里,小牛,彩云和火山翻译。A concise and elegant Dictionary and Translator macOS App… The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Commit messages
  • Tasks that involve Pull requests

Example prompts

  • “/submit-pr”

Requirements

  • Python 3

Workflow steps

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

  1. 读取 工作流契约,确定用户语言、固定正文、Issue 策略、repository
  2. 记录 HEAD、当前分支和 staged、unstaged、untracked 边界。若 checkout 处于 detached 状态
  3. plan 模式只使用现有提交和缓存的远程事实,运行 helper plan 并展示完整 PR 预览。
  4. 默认或 draft 模式要求工作树可安全交付
  5. 根据真实范围起草 Context、Changes 和 Verification;不读取目标仓库中的
  6. 使用相同内容运行 helper apply;draft 追加 --draft。helper 重新发现并校验本地/远程状态,
  7. 报告 PR URL、base/head repository 与 branch、head SHA、Draft、分支/push/PR 动作和截图提醒。

What it can do on your machine

Read from SKILL.md and the folder at commit cfda6e2. 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/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • 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

Submit PR loads about 595 tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 223 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~595
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

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 tisfeng/Easydict at commit cfda6e2, republished under its GPL-3.0 licence (© tisfeng). 223 words, ~595 tokens.

Download SKILL.mdSave it as .claude/skills/submit-pr/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
submit-pr
description
创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

提交 GitHub PR

根据当前 Git checkout 的已提交变更,规划、创建或复用 GitHub Pull Request。 <submit-pr-skill-dir> 指实际加载的本 Skill 目录。 PR 正文只使用 Skill 自带的 固定模板;不发现、读取或合并目标 仓库的 GitHub PR 模板。

模式与授权

  • plan:只读发现仓库拓扑,预览提交范围、标题、正文、base、head 和 push remote; 不 fetch、创建分支、写仓库文件、push 或创建 PR。
  • 默认:在明确的 PR 交付授权下,fetch 精确 base、推送任务分支、创建或复用正式 PR, 并验证最终远程状态。
  • draft:与默认模式相同,但创建 Draft PR。

用户未指定时使用默认模式。用户的只读、确认、暂缓和范围限制持续有效。

只有需要把既有 staged 内容创建为提交时才依赖 git-commit。从当前 Skill 清单定位实际入口, 未提供位置时才检查 同级安装位置。干净的已有提交和纯 plan 不要求 该依赖;需要提交但依赖缺失时,可继续只读检查,但在提交、fetch 或 push 前停止。

主流程

  1. 读取 工作流契约,确定用户语言、固定正文、Issue 策略、repository 拓扑、base/head 分支与恢复规则。
  2. 记录 HEAD、当前分支和 staged、unstaged、untracked 边界。若 checkout 处于 detached 状态:
    • 用户明确名称或项目既有命名优先;否则根据任务与只读 diff 选择最窄 Angular type,生成 <type>/<english-kebab-case-summary>。
    • 使用 git check-ref-format --branch 验证字面名称,并在本轮 plan 与 apply 都显式传入 --head-branch;调用 Agent 不在 helper 之外创建或切换分支。
  3. plan 模式只使用现有提交和缓存的远程事实,运行 helper plan 并展示完整 PR 预览。 缺少提交或 cached base 时报告预览缺口,不为使 plan 成功而写入。
  4. 默认或 draft 模式要求工作树可安全交付:
    • 存在 unstaged 或 untracked 内容时停止,不运行 git add。
    • 仅 staged 非空时,按宿主交付规则使用 git-commit;工作树干净时复用已有提交。
    • 精确 fetch base ref,检查完整 <base-remote>/<base>..HEAD 提交与文件范围。 范围为空、来源不明或 HEAD 未包含 base 时停止,不自动修正历史。
  5. 根据真实范围起草 Context、Changes 和 Verification;不读取目标仓库中的 pull_request_template 文件或目录。运行 helper plan 并展示语言来源和完整预览。 默认模式继续;用户要求确认或暂缓时先停止。
  6. 使用相同内容运行 helper apply;draft 追加 --draft。helper 重新发现并校验本地/远程状态, 精确 push,创建或复用 PR,然后读回验证身份、head SHA、title、body 和 Draft 状态。
  7. 报告 PR URL、base/head repository 与 branch、head SHA、Draft、分支/push/PR 动作和截图提醒。 本轮创建提交时同时保留 git-commit 的完整回执。

安全、完成与停止

  • 只支持 GitHub remote;拓扑有歧义时要求显式参数,不创建 fork。
  • 不 force push,不 rebase、merge、reset、stash、删除 remote/分支,不切换 checkout 或推送保护分支。
  • detached checkout 只在 helper apply 内从冻结 HEAD 创建或复用命名分支 ref;plan 不创建 ref, apply 后 checkout 仍保持 detached。
  • 不自动添加 reviewer、label、milestone 或 project,不 merge PR、评论或关闭 Issue。
  • 只有 helper apply 返回成功且 pr_verification.status == "passed" 时才声称 PR 交付完成。 默认不等待 CI;仅在用户或宿主规则要求时查询或等待 checks。
  • 远程实体或已有 PR 与冻结计划不匹配、范围/身份漂移、授权被拒或写后验证失败时, 保留已完成动作并停止;不覆盖维护者编辑、创建第二个 PR 或重复已成功的远程写入。

© tisfeng, GPL-3.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 5 other files (scripts, references, assets) in .agents/skills/submit-pr of tisfeng/Easydict.

  • SKILL.md
  • agents/openai.yaml
  • assets/pull_request_template.md
  • references/workflow.md
  • scripts/submit_pr.py
  • tests/test_submit_pr.py

Open the folder on GitHubat commit cfda6e2

Compare with similar skills

Submit PR 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.

Submit PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Submit PR this skilltisfeng/Easydict15k—~595Automated safety check: PassGPL-3.0
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0
Create PREmiyaaaaa/HiveMind1.1k—~1.7kAutomated safety check: PassCustom licence
Create Pull Requestantfu/skills5.9k—~1.2kAutomated safety check: PassMIT

Similar skills

  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes
  • Create PR

    Emiyaaaaa/HiveMind

    Create a GitHub pull request with gh pr create. An agent skill from Emiyaaaaa/HiveMind.

    1.1k GitHub stars~1.7k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Publishes a GitHub PR for the checked-out branch with a Conventional Commits style title, a description backed by commands run, and screenshots when the UI changed.

    5.9k GitHub stars~1.2k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Commit And PR

    389ds/389-ds-base

    Commit and open a PR the 389-ds-base way — "Issue NNNN - summary" subject, Bug Description/Fix Description body, Fixes:/Relates: trailer, AI-attribution trailer, and squash-merge etiquette.

    294 GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from tisfeng/Easydict

All 8 skills in this repo
  • Fireworks Tech Graph

    tisfeng/Easydict

    Create precise SVG technical diagrams, export PNG or offline HTML, and animate supported semantic SVGs to GIF.

    15k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Release Easydict

    tisfeng/Easydict

    编排 Easydict macOS 的 draft、publish、release 和 resume,整理英文 GitHub Release 内容,并处理发布后的 Issue 跟进及本地清理。不用于一般的发布流程设计讨论。

    15k GitHub stars~810 tokensUpdated 2 days ago
    Auto-check passed
  • Git Commit

    tisfeng/Easydict

    起草、创建或汇报 Angular-style 本地 Git 提交。用于明确的提交交付;分支集成使用 worktree-rebase-merge,不 push。

    15k GitHub stars~535 tokensUpdated 2 days ago
    Auto-check passed
  • Review

    tisfeng/Easydict

    审查本地工作树、提交、range、文件或模块,找出有证据的缺陷。GitHub PR 审查使用 review-pr;代码清理使用 code-simplifier。

    15k GitHub stars~659 tokensUpdated 2 days ago
    Auto-check passed
  • Review PR

    tisfeng/Easydict

    审查 GitHub PR 的准确 head/base diff、关联 issue、CI 和 review threads,交付前刷新。创建 PR 使用 submit-pr;本地审查使用 review。

    15k GitHub stars~723 tokensUpdated 2 days ago
    Auto-check passed
  • Worktree Rebase Merge

    tisfeng/Easydict

    将当前 worktree 的任务提交 rebase 到本地目标分支,并从目标 worktree 合并。用于明确要求本地集成;仅创建提交使用 git-commit。

    15k GitHub stars~408 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Submit PR

What does Submit PR do?

创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。. Submit PR is an agent skill from tisfeng/Easydict.

When should I use Submit PR?

Submit PR fits situations like: tasks that involve Commit messages; tasks that involve Pull requests.

How do I install Submit PR in Claude Code?

Run `npx skills add tisfeng/Easydict --skill submit-pr -a claude-code`. Or copy the skill folder (.agents/skills/submit-pr in tisfeng/Easydict) into .claude/skills/submit-pr in your project. Claude Code loads it when a task matches its description.

How do I install Submit PR in Codex?

Run `npx skills add tisfeng/Easydict --skill submit-pr -a codex`. Or copy the skill folder (.agents/skills/submit-pr in tisfeng/Easydict) into .agents/skills/submit-pr in your project. Codex loads it when a task matches its description.

Can I use Submit PR 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 tisfeng/Easydict --skill submit-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/submit-pr, .gemini/skills/submit-pr, .github/skills/submit-pr and .opencode/skills/submit-pr in your project.

What does Submit PR need to run?

Going by SKILL.md and its folder, Submit PR needs Python for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Submit PR 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 Submit PR 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 Submit PR use?

Submit PR is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Submit PR use?

About 595 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Submit PR?

Skills that share tags, products or a category with Submit PR: React Router Pull Request Creator (remix-run/react-router, 57k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars), Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars) and Create PR (Emiyaaaaa/HiveMind, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Submit PR?

tisfeng (a GitHub user) maintains it in tisfeng/Easydict, which has 14,866 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 6, 2026.

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