neo-pr
Skill7 starsChanged 6 months agoMITView on GitHub
Use this skill when the user asks to create, draft, review, format, or generate a Pull Request (PR) title and description, specify target or source branches for a repository, or convert git branch diffs into concise, high-impact, non-AI-slop PR content.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- generate-skillSkill
- neo-azure-pipelinesSkill
- neo-clarificationSkill
- neo-clean-architectureSkill
- neo-code-reviewSkill
- neo-csharp-interface-generatorSkill
- neo-csharpSkill
- neo-dotnet-ef-coreSkill
- neo-dotnet-minimal-apisSkill
- neo-dotnet-mvcSkill
- neo-dotnetSkill
- neo-dotnet-tag-helperSkill
- neo-dotnet-webapiSkill
- neo-harness-projectSkill
- neo-harnessSkill
- neo-javascriptSkill
- neo-opentelemetrySkill
- neo-python-managerSkill
- neo-pythonSkill
- neo-rabbitmqSkill
- neo-rustSkill
- neo-stop-slopSkill
- neo-sub-agentSkill
- neo-swiftSkill
- neo-swift-uiSkill
- neo-typescriptSkill
- neo-vueSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 23
Non-existent or Unaligned Branches: If the specified source or target branch does not exist locally or on remote, prompt the user to run …
- Distinctive: line 24
Overly Long Diffs and Token Overhead: If the branch diff spans dozens of files or thousands of lines, inspect git diff --stat and commit …
- Distinctive: line 25
De-slop Does Not Mean Removing Technical Substance: When stripping AI fluff, eliminate throat-clearing openers (e.g., "It is worth noting …
- Distinctive: line 48
If the user has not specified branches, ask with a concise prompt:
- Very specific: line 56
PR Structure & Template: Read references/pr-template.md for standard markdown sections.
- Very specific: line 63
Run git-pr-extractor.py non-interactively in the target repository directory:
- Distinctive: line 84
Do not begin with filler phrases ("This PR implements...", "A commit to...").
- Distinctive: line 85
Keep under 50 characters, imperative mood, direct and actionable.
- Distinctive: line 109
Ensure no critical modifications are omitted from the generated title or description.
- Very specific: line 110
Run de-slop score check if skills/neo-stop-slop/scripts/analyze-slop.js is available:
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Neo PR Generator & Refiner
neo-pr is an expert skill engineered to generate precise, concise, and non-AI-slop Pull Request (PR) titles and descriptions for Git repositories. It proactively guides the user to clarify repository and branch targets, extracts change histories, and outputs clear, highly structured PR content.
Gotchas
- Non-existent or Unaligned Branches: If the specified source or target branch does not exist locally or on remote, prompt the user to run
git fetchor provide the correct branch name. Do not invent non-existent base branches. - Overly Long Diffs and Token Overhead: If the branch diff spans dozens of files or thousands of lines, inspect
git diff --statand commit logs first to gain high-level context instead of loading full diffs at once. - De-slop Does Not Mean Removing Technical Substance: When stripping AI fluff, eliminate throat-clearing openers (e.g., "It is worth noting that...", "This PR aims to..."), but strictly preserve essential context, key logic shifts, breaking changes, and test instructions.
Workflow Checklist
- Step 1 — Perceive (Gather Branch & Repository Context): Identify the repository path, source branch (
source branch), and target branch (target branch). If unspecified, prompt the user or detect the current Git state. - Step 2 — Reason & Load References (Load Templates & Guidelines): Read pr-template.md for structural standards and de-slop conventions.
- Step 3 — Act: Extract Diff (Fetch Change Record): Execute the helper script
git-pr-extractor.pyto retrieve commit logs, file statistics, and diff snippets. - Step 4 — Act: Generate & De-slop (Produce Concise PR Content): Write a Conventional Commits title and bulleted PR description while eliminating all AI tells.
- Step 5 — Verify (Quality Check): Verify that the generated title and description adhere to de-slop standards (optionally run
analyze-slop.jsto score density).
Detailed Guidelines
Step 1 — Perceive (Gather Branch & Repository Context)
Determine the following core parameters:
- Repository Context: Current working directory or specified GitHub/GitLab workspace.
- Source Branch: Branch containing the new changes (e.g.,
feature/user-author current checked-out branch). - Target Branch: Base branch to merge into (e.g.,
main,master, ordevelop).
If the user has not specified branches, ask with a concise prompt:
"Please specify your source branch (e.g.,
feature/xxx) and target branch (e.g.,mainordevelop). If omitted, I will default to PRing the current branch intomain."
Step 2 — Reason & Load References
Load relevant design documents based on diff scope:
- PR Structure & Template: Read
references/pr-template.mdfor standard markdown sections. - De-slop Rules: Apply core
neo-stop-slopprinciples (active voice, remove filler phrases, focus on objective facts).
Step 3 — Act: Extract Diff (Fetch Change Record)
Run git-pr-extractor.py non-interactively in the target repository directory:
python3 skills/neo-pr/scripts/git-pr-extractor.py --target-branch <target> --source-branch <source>Alternatively, run native Git commands if script execution is unavailable:
git log <target>..<source> --oneline
git diff <target>..<source> --statStep 4 — Act: Generate & De-slop (Produce Concise PR Content)
Construct the PR Title and Description based on extracted commit and diff context.
1. PR Title Standard (Conventional Commits)
- Format:
<type>(<scope>): <short summary> - Example:
feat(auth): 新增 JWT 驗證與 Token 自動刷新 - Rules:
- Do not begin with filler phrases ("This PR implements...", "A commit to...").
- Keep under 50 characters, imperative mood, direct and actionable.
2. PR Output Standard Structure
The PR output must strictly be wrapped in a Markdown code block (i.e. raw Markdown source code ```markdown ... ```) so that users can easily copy it directly into GitHub/GitLab PR description fields. The content inside the code block must consist exclusively of the following two sections:
```markdown
標題:
<Conventional Commits 格式標題>
內容:
- 列點並重點化的說明重要變更內容(包含主要模組/檔案調整、邏輯變更與重大影響)。
```3. Strict De-slop Rules
- ❌ Never use: "It is worth noting that", "Needless to say", "This PR aims to", "In summary", "Clearly".
- ❌ Avoid hyperbolic fluff: "dramatically improves", "seamlessly integrates", "highly robust".
- ⭕ Use concrete facts & metrics: "reduces response latency by 30ms", "fixes NullReferenceException on null payload".
Step 5 — Verify (Quality Check)
- Ensure no critical modifications are omitted from the generated title or description.
- Run de-slop score check if
skills/neo-stop-slop/scripts/analyze-slop.jsis available:
Confirmnode skills/neo-stop-slop/scripts/analyze-slop.js --input "<generated PR description>" --format jsonslopDensityScoreis under 0.5% (Grade A+).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

