create-pr
Creates pull requests with bilingual documentation checks. Use when user asks to create PR, make a pull request, or submit changes for review. Ensures English and Chinese README files stay in sync when user-facing skill catalog changes require it.
By zhaono1 · 659 installs
npx skills add zhaono1/agent-playbook --skill create-pr
Source repository · Upstream listing
Create PR
A skill for creating pull requests with bilingual documentation checks. This skill ensures that English and Chinese documentation stay in sync before code changes are submitted.
When This Skill Activates
This skill activates when you:
Ask to create a pull request or PR
Say "submit my changes" or "push and create PR"
Mention "make a PR" or "open a pull request"
Want to submit code for review
PR Creation Workflow
Step 1: Analyze Changes
Examine all changes in the current branch:
Identify:
Modified files : What was changed?
New files : What was added?
Deleted files : What was removed?
Impact area : Which skills or features are affected?
Step 2: Determine Documentation Updates
Check for Skill Changes
First, detect if any skills were changed:
Decision Matrix
Change Type Documentation Action
New skill added Add to skills table in both EN and CN README
Skill description changed Update description in skills table
Skill removed Remove from skills table
Skill hooks changed Update Auto Trigger column in skills table
Internal skill logic only Skip README update
Bug fix with no user impact Skip README update
Auto Trigger Changes Require Update
If a skill's metadata.hooks front matter was modified, the Auto Trigger column in the Skills Catalog must be updated:
If hooks changed → Update README.md and README.zh CN.md Auto Trigger column.
Step 3: Draft Commit Message
Use the commit helper format:
Types:
feat : New skill or feature
fix : Bug fix or correction
docs : Documentation only changes
refactor : Code refactoring
chore : Maintenance tasks
Step 4: Create the Pull Request
Run the following sequence:
Step 5: Update Documentation (If Required)
Before committing or creating the PR, update both README files when the change
affects user facing skill catalog, installation, or workflow behavior:
README.md (English):
Add new skills to appropriate category table
Update project structure if needed
Keep language switch link at top
README.zh CN.md (Chinese):
Mirror all English changes
Translate skill descriptions
Maintain same structure and formatting
Step 6: Update Changelog (Optional)
For significant changes, add to CHANGELOG.md:
Documentation Update Guidelines
Skills Catalog Update Template
When adding or modifying skills, use this format for the Skills Catalog:
English (README.md):
Chinese (README.zh CN.md):
Auto Trigger Column Values
Value Meaning Example
Manual User must invoke Most development skills
Auto Triggers automatically after any skill session logger
Background Runs non blocking after related skill self improving agent
After skill updates Only triggers when skills are modified create pr
(keyword: "...") Activates on specific keyword prd planner (keyword: "PRD")
When to Update README
Always update when:
Adding a new skill
Removing a skill
Changing skill names or descriptions
Restructuring the skills directory
Consider updating when:
Adding significant features to existing skills
Changing installation instructions
Modifying project structure
Skip updating when:
Internal code refactoring with no user impact
Minor typo fixes
Test file changes
Bilingual Update Format
When adding a new skill to the skills table:
English (README.md):
Chinese (README.zh CN.md):
Language Switch Link
Both README files must have the language switch at the top:
README.md:
README.zh CN.md:
PR Description Template
When creating a PR, use this template:
Common Scenarios
Scenario 1: Adding a New Skill
Scenario 2: Modifying an Existing Skill
Scenario 3: Bug Fix Only
Verification Checklist
Before creating the PR, verify:
[ ] All changes are committed
[ ] Branch is pushed to remote
[ ] Commit messages follow Conventional Commits
[ ] README.md is updated if needed
[ ] README.zh CN.md is updated if needed
[ ] Language switch links are present in both READMEs
[ ] New skills have symlinks created
[ ] PR title is clear and descriptive
[ ] PR description includes summary and changes
Quick Reference
Command Purpose
git status Check current state
git diff See unstaged changes
git log main..HEAD See branch commits
git add <changed files Stage only intended files
git commit m "msg" Commit with message
git push u origin branch Push to remote
gh pr create Create pull request
Tips
1. Commit first, PR later : Always commit changes before creating PR
2. Small PRs : Keep PRs focused on a single change
3. Clear titles : Use Conventional Commits in PR titles
4. Bilingual sync : Always update both README files together
5. Test skills : Verify skills work before submitting PR